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INTRODUCTION 



ww£?'! P acka &es, like people, usually have "personalities". It is THE ELECTRIC 
PENCIL 8 personality that makes it easy to use. Unlike other word processors, it 
has a simple two-keystroke command structure. In plain english, this means that 

tJXitb? y ™™ w t0 ™™r tW ° k6y8 t0 eXeCute any of the "control commands" such as 
INSERT, DELETE, PRINT and others. 

bef^ U ELECTRI ! : PEN " L does Q ot require a six hour tape instruction course 
before you can learn how to use it. You will not have to keep your nose in a 

TZZi v <* Xt - d ° the thin8S y ° U Want * You d0 not need 8 P ec ^l key-decals to 
s^x" ^ fUnCt " nS ; U doeS not «<* ui " that you use ciplicfT "command 

able L ^°^ aC T P h ? e ' hinSS y0U want t0 d0 ' In fact » y° u w^l Probably be 

™ t ™™ g P roductlve us e of THE ELECTRIC PENCIL in under one hour! 
texfL ? / 1C PENCIL " a Character 0rieil ted Word Processer. This means that 
(T "JJil* r n t S a coiat "^™s "string" of characters and is handled as such. 
IL /'J" 8 of c ^racters" means a group of letters, symbols and numbers - like 
the text your are reading now.) This allows you enormous freedom and ease in 
the movement and handling of text. Since the lines that will be sent to the 

S^Lk" n0t s P eCified in advaDCe » an y QUmb « of characters, words, lines or 
paragraphs may be inserted or deleted anywhere in the text. The entire text is 
Shifted as you insert and delete characters. 

c -,-« The tyP , in8 ° f carria S e returns as well as word hyphenation is not required 
since each line of text is formatted automatically. As text is typed in and the 
tlti • a * SC Z ee ? line . is reached, a partially completed word is shifted to the 
beginning of the following line. This makes the text easier to read because 

£rl!%^ r % "?• br ° ken ° r tD USe com P uter i«gon, "wrapped around" the screen, 
j- rum lx lie to lme . * 

shi?t!nr F teXt .„ iS inserted or de l eted » existing text is shifted down or 
shifted up. Everything appears on the video display screen as it occurs, and 

8crolltnr^T„ 8 i eSSW0rk - T6Xt My be revie wed at will, by variable speed 
scrolling in both directions. y 

By using the SEARCH or the SEARCH and REPLACE function, any "string" of 

Specifir 8 s rts of ^""f and/or "P laced ^ th «* other "string" of characters. 
Specific sets of characters within encoded strings may also be located and used 
in creating selective mailing lists. 

^^ heQ J 6Xt u 8 printed » ME ELECTRIC PENCIL automatically inserts carriage 
returns where they are needed. Many combinations of line length, page length 

h^ aC S er D S f a " n8 '. Une SpaciDg ^ P a * e 8 P aci *S allow for any form to be 
handled. Right Justification gives right-hand margins that are even. Pages may 
be numbered as well as titled. * 

MODF? ^tt fUU advanta S e ° f ™E ELECTRIC PENCIL for the TRS-80 MODEL I (The 
MODEL HI comes with the lower case already inatalled.) the lower case 
modification kit should be installed. (The MODEL III comes with the lower case 

win 8 L XnStal J ed * > J T ? ere are tW ° typeS 0f lower ca8e kite and b °t* work equally 
well. One is offered by RADIO SHACK and the second type is one you may install 

deslnif; ,H h£ b °S k ;. ,The . Cu6to * ^S-SO and Other Mysteries", by Dennis B. Kitsz, 

describes this modification in detail. In addition, a companion kit by TEKNOPAK 

the kit PUrChaSed Wlth al1 0f the h «dware and instructions necessary to install 

The kit is available through your local TEKNOPAK dealer. If your local 

blX'r.? ^T ° niCS dgaler d ° eS nOC Ca " y the kit > there is * "upon at the 
back of this book. 
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USING THIS BOOK 



Instructions are usually dull, boring, and tedious. The language used only 
faintly resembles English, and is full of computer jargon and explanations that 
only a programmer could understand are used to explain the simplest things. In 
this book we have used explanations and examples that anyone can understand. In 
addition, there is a GLOSSARY at the back of this book which will clarify the 
jargon; In less than an hour anyone can start using THE ELECTRIC PENCIL 
productively I In less than a few hours you can be an "expert" at it. 

The best way to learn to use THE ELECTRIC PENCIL is to try using the commands as 
you read about them. By experimenting with different combinations of commands 
and using TEE ELECTRIC PENCIL, you will discover the best way to do the things 
YOU want to do. 



it 



If this is the first time you have used a word processor or the computer is 
" to you or both, then before proceeding, we would recommend that you 
thoroughly review the TRS^DOS manual. 



NOTATION 

One of the most frustrating and confusing things about an instructional book for 
a computer (This goes for the writer as well as the reader I) is the NOTATION 
used to indicate what YOU enter Cor type) into the computer, what the computer 
prints out on the video screen, or how we indicate in a book, a SEQUENCE of keys 
to press or keys that must be PRESSED AT THE SAME TIME, Here are the special 
notations we have used in this book along with their explanations: 

<K> A letter or word enclosed in this type of bracket indicates a key. In this 
case, the "K" key. <SHIFT> or <SFT> would indicate the "SHIFT" key. 

<CT^> or <CONTROL> THE ELECTRIC PENCIL may use either a specially installed 
"control" key or the "CLEAR" key as a control key. This symbol will indicate 
that the "CONTROL" key is to be pressed. If you do not have a special control 
key, then the "CLEAR" key is the control key. 

"filesnec" Means, FILE SPECIFICATION. The computer stores all information on 
diskettes as a "file" - picture it as a file folder with a name on it» 
Programs stored on diskettes are files. Data stored on diskettes are also 
"files"* If you want a particular file folder out of your file cabinet at home 
or work, you must know the NAME of the file you want. (Excuse me f could you pull^ 
the Jones File and put it on my desk?) The computer works in the same way - in 
order to get a file, we have to have a FILE SPECIFICATION which is the name of 

the file. 

On the TRS-80, you must enter a valid TRSDOS file specification. See the 
"TRS-DOS Disk Operating System Manual" section 3, page 6* 
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Everyone (almost everyone, anyway) has a first and last name. File names can 
have first and last names too. When a file has a "last name" we call it an 
EXTENSION or FILE NAME EXTENSION. THE ELECTRIC PENCIL uses its own file 
extension; /PCL". This is how it recognizes its own files when you display the 
disk directory. You may also enter your own file extension (i.e., filenames with 
extension other than "/PCL") and these will be displayed in the directory on 
disk systems. This is done by using the asterisk option with the DIR command. 
(Also see DIR and SAVE.) 

There is one more thing about file names: So far we have FIRST names, LAST 
names and now we have passwords. If you worked for the CIA, you would have a 

call'vou b^Lf* 5 - YO ? r u i d '•"„*«« 8 «rets only to those people that could 
call you by this special "code name" or password. Files can have passwords too. 
it you try to LOAD a file that has a password and you don't give the password. 

o£% c S1p E ci F iciTio\r u thi8 me8sa8e: FILE ACCESS DENIED - Here are the part8 



File name 



(EXAMPLE) 



File name extension separator 



Drive specification separator 



CO 



EXAMPLE/ PCL. BLUE 
' l i A 



File name extension 



(PCL) 

Password separator 



Disk drive specification 



(1) 
. Password 



(-) 



(BLUE) 



In the above example we have a file with the name, "EXAMPLE" whose extension is 
"PCL", its password is "BLUE" and it is on disk drive number "1". 

<ENTER> The "enter key" is the large white key on the right side of the 
keyboard. It even has the word "enter" right on it. It corresponds to the 
carriage return' 1 key on an electric typewriter. 

The <ENTER> key does not have a character symbol of its own. When we are 
using a word processor, we need to be able to see some kind of a symbol to 
indicate that a carriage return was entered. THE ELECTRIC PENCIL uses a "left 
arrow 11 symbol to indicate a carriage return, it looks like this; <- 



- nppp means to use a number in place of 
a notation that looks like this: 



'nnnn% For instance, suppose you see 



'PLnnn <ENTER>' 1 where 'nnn' is a number between ti and 255 

then you would substitute a number between zero and two-hundred fifty-five for 
'nnn'. If the number you wanted was "10" then you would type: 



PL! (J <ENTER> 
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<CTL>-<T> Brackets with a hyphen between them indicates that both keys are to be 
pressed AT THE SAME TIME I In this case you would hold the control key down while 
you pressed the "T" key. 

<CTL>-<R>, n. n. <anv key> This is ELECTRIC PENCIL'S "repeat" function. Any key 
or command may be repeated. Let's suppose that you want a string of 50 asterisks 
across the page like this: 



you would press the keys like this: 

1. Hold down the <CONTROL> key and press the <R> key, 

2. Release the <C0NTR0L> and <R> keys. 

3. Press the <5> key. 

4. Press the <(j> key. 

5. Press the <*> key. 

SPACES AMD OTHER SPECIAL CHARACT ERS - A difficult concept to grasp is that 
"spaces' 1 are treated as "characters 11 or symbols. A "character" is anything that 
appears on your video screen when you press a key. Here is a list of the 
different types of characters your computer can make: 

Letter characters - "A" through "Z" in upper and lower case. 

Number characters - "(J" through "9" 

Symbol character s - "I", "%", "*" or any non-letter or number character that 
may be entered from the keyboard by -pressing a single key or combination of 
keys. Some characters however* cannot be generated from the keyboard at all. The 
underline character is one of these. It is stored in the computer but there is 
no underline key. THE ELECTRIC PENCIL generates this character when the <CLEAR> 
or <CTL> and <0> key are pressed at the same time. _ 

"Unpr intabl e character s " - These characters are generated when you press a key, 
like the "BREAK" key. There are no symbols for these "characters; but 
sometimes, in order to "see" them, we assign a character to REPRESENT the 
"unprintable" character. The <ENTER> or "CARRIAGE RETURN 11 key is one of the 
"unprintable" characters and we have ASSIGNED the left arrow C <- ) to represent 
that key. There are other "unprintable" characters that THE ELECTRIC PENCIL does 
not assign characters to at all, but they are of no particular concern to us. 

A "space" or "blank" on the screen (such as the space between two words) is a 
character — we just cannot see it. It is treated as any other character, 
however. We can only "see" a space character when we can see other characters on 
either side of it. Spaces are ALWAYS considered when entering, formatting, or 
printing, just like any other character. 

Because they cannot be "seen", at least like we "see" any other character, we* 
sometimes forget that they exist. This can, from time to time, cause some 
problems that we would not consider if we were using an ordinary typewriter. 
Whenever you have a problem with your text and cannot seem to find a solution 
for it, look for the "unseen" - usually a group of SPACES or a SPACE in the 
wrong place that has escaped your attention. 

The UBIQUITOUS ZERO - Ubiquitous means; existing everywhere. The zero character 
looks like the capital letter "0" and it is everywhere. The confusion arises 
when we need to represent a zero, not the letter "0 M . So to eliminate the 
Confusion, we will make the NUMBER ZERO like this; 
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THE HISTORY OF THE ELECTRIC PENCIL 

S"^ :J an ? ar y of 1975. aa article in Popular Electronics Magazine caught the eye 
01 Michael Shrayer. It was about one of the then "new" hobby computers. He had 
just come to California, after a successful career as a commercial and 

ST*!* * fllm director ^ caraera ™ n - Looking for a new challenge, he wrote 
the manufacturer, requesting more information. 

Electronics was not a new interest to Michael, since he bad been an avid 
amateur radio hobbyist (WA6SQW) most of his life. Computers might be something 

MI?S W A™r° Ve ln 5 eres | :ill S- In f fe * weeks, the information on the computer, a 
MITS ALTAIR computer kit, arrived. It looked interesting and didn't seem too 
expensive. Michael made up his mind quickly and soon the MITS company had his 
money and Michael was the owner of a computer kit. 

Its assembly went quickly. It was a large metal box and had no video, keyboard 
or storage device. A program had to be keyed into the computer with a "front 
panel consisting of switches and lights. When the "RUN" switch was pressed, the 
computer displayed its results with lights. It took several hours to "key in" a 
simple program. There was do way to "SAVE" it. Each time he wanted to run a new 
program, several hours had to be spent keying in a new program and debugging the 
mistakes that were a result of mis- keying. 

In the beginning, he did not know machine code or how to write a machine 
language program so he had to be content with keying in a simple program, 
supplied with the computer, that made the computer play a song. After a three 
Hour keying-in session, the computer would play "A Fool On The Hill". Michael 
was not thrilled with that for very long. 

In 1975. the coming "computer boom" was not evident to most of us. It was a 
kind of underground movement with computer professionals, engineers and a few 
mavericks, like Shrayer. There is an old saw, that birds of a feather flock 
together. The computer birds sought each other out and organized into clubs. 

Within a short time, Michael had added a paper tape punch to store and load 
programs, and a video screen and keyboard. The MITS was starting to look like a 
real computer. Soon he was buying and selling hardware, writing machine 
language programs and having a hell of a good time. 

Michael had decided that "computers were fun" but by now he wanted to find 

v»?L.rT , taSk that U COuld d0 ' Some thing that would make it a truly 
VALUABLE tool, not just a gadget that would play a song. 

All during this time, Michael had only used the computer to write programs 
that would assist him in writing other programs. His first editor- assembler 
program, purchased from Processor Technology, was called "SOFTWARE PACKAGE 1 " 
To Michael's way of thinking, it needed some improvements. He made the 
improvements and called it "EXTENDED SOFTWARE PACKAGE 1." or "ESP-1". Now he had 
to write the documentation — ON A TYPEWRITER! 

Before this he had never heard of a word processor. It was a new idea to him 
and besides, he needed such a program for his own documentation chores. Tearing 
^St problem wlth a vengeance, in a few months he had a crude version of the 
PENCIL up and running on the ALTAIR. In a few more months, it was debugged 

The first job that Michael had THE ELECTRIC PENCIL do was to writ*." thp 
ELECTRIC PENCIL documentation! rite ™ E 
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Michael had no idea that THE ELECTRIC PENCIL would result in his going into the 
business of selling his own software. The word spread and he was soon 
duplicating and selling THE ELECTRIC PENCIL word processing system. At that 
time, THE ELECTRIC PENCIL was the ONLY word processor available on a 
microcomputer and there was a clamor from owners of different machines, to make 
it available for their machines too. 

From 1976 to 1980 seventy-eight versions of THE ELECTRIC PENCIL were written 
to run on various computers and under different operating systems. Just keeping 
up with all the different machines, let alone the various operating systems, 
began to take the "fun" out of having a computer, for Michael. 

Some of the computer companies went out of business eliminating the need for 
some versions of THE ELECTRIC PENCIL but others quickly took their place. 

In late 1978 the TRS^SO entered the great computer race. In a short time, THE 
ELECTRIC PENCIL was, as they say in the computer world, "up and running" on the 
TRSr-80, at first as a tape version and later as a disk version. 

Shrayer continued to sell the package until January of 1981. By this time THE 
ELECTRIC PENCIL was losing ground to other word processors, not because they 
were better but because the market had changed. Michael was not ready to devote 
his life to the daily chores of marketing, accounting, advertising, and the 
thousand and one details of doing business around the world. 

Harvard Pennington, an avid fan of THE ELECTRIC PENCIL and the president of 
IJG, Inc., proposed that IJG take over the job of supporting and marketing THE 
ELECTRIC PENCIL. Michael, seeing an opportunity to return to having "fun" with 
his computer, agreed. 

IJG had a special interest in THE ELECTRIC PENCIL too, Pennington had used 
THE ELECTRIC PENCIL to write his book, "TRS^SO Disk and Other Mysteries". 
Pleased with how easy it was to use, he, like many others, had several versions 
modified to his own specifications by patching the PENCIL code. One was a 
"communications" version and another was a "typesetting" version. Each was used 
for special tasks. 

The "communications" version permitted him to send and receive text over the 
telephone. The "typesetting" version allowed him to set type for IJG's budding 
publishing division, Pennington's plan was to have authors write their books on 
the TRS^80 using THE ELECTRIC PENCIL then send their text over the phone to 
IJG, where the text would be saved to disk. Now the text could be edited and 
worked on and when ready, the disks would be sent to the typesetter where type 
would be set directly from the disk using THE ELECTRIC PENCIL as the software 
interface between the TRS-80 and the type setting machine. 

Knowing what the PENCIL was capable of and liking its easy-to-use command 
structure (which is particularly suited to authors and writers who want to 
create texts without spending hour on hour examining manuals, deciphering 
embedded codes and trying to figure out what the hell to do next) Pennington got 
together with a couple of THE ELECTRIC PENCIL fans and machine language 
programmers and planned the release of the current version. This version was to 
be assembled from source code, not simply patched in a haphazard way. Great care 
was taken to retain the essence of the original simplicity of commands and yet 
allow sophisticated text processing and print formatting. The task was 
undertaken and completed in record time. 

And that, brings us to the present. Over five years of continuous use by tens 
of thousands have made THE ELECTRIC PENCIL the most popular word processor in 
use around the world. 



THE ELECTRIC PENCIL Version 2 .Oz 



SYSTEM HARDWARE REQUIREMENTS 



^^^St!^ 8 1*" ° f "? e minimum e<l«ipi«nt that is required to operate THE 
ELECTRIC PENCIL Word Processing System: 

TAPE SYSTEM: 

TRS-80 Level II Microcomputer MODEL I or MODEL III 

16K RAM memory (minimum) 

Cassette Recorder 

Radio Shack Expansion Interface (optional) 

Radio Shack RS-232 interface (optional) 

Small System Hardware TRS-232 Interface (optional) 

Serial or Parallel printer (optional) 

Lower case modification kit (optional) 

EXATRON Stringy Floppy (optional) 



STRINGY FLOPPY SYSTEM: 

TRS-80 Level II Microcomputer MODEL I or MODEL III 

16K RAM memory (minimum) 

EXATRON Stringy Floppy drive unit 

Radio Shack Expansion Interface (optional) 

Radio Shack RS-232 interface (optional) 

Small System Hardware TRS-232 Interface (optional) 

Serial or Parallel printer (optional) 

Lover case modification kit (optional) 

Cassette Recorder (optional) 

DISK SYSTEM: 

TRS-80 Level II, MODEL I or MODEL III 

32K RAM memory (minimum) 

Radio Shack Expansion Interface 

1 Disk Drive (minimum- MODEL I) 

2 Disk Drives (minimum- MODEL III) 
Radio Shack RS-232 interface (optional) 

Small System Hardware TRS^232 Interface (optional) 

Serial or Parallel printer (optional) 

Lower case modification kit (optional) 

Cassette Recorder (optional) 

EXATRON Stringy Floppy (optional) 

Disk Operating System Software which may be 

any one of the following: 



NEWDOS 2 .1 
NEWDOS/80 1.0 
NEWDOS/ 80 2.0 
TRS-DOS 2 .3 
NEWDOS/80 2 ,0 
TRS-DOS 1.2 
TRS-DOS 1.3 



(MODEL I) 
(MODEL I) 
(MODEL X) 
(MODEL I) 
(MODEL III) 
(MODEL III) 
(MODEL III) 
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LOADING INSTRUCTIONS 



THE ELECTRIC PENCIL is furnished on cassette for cassette users, disk for disk 

users and Stringy Floppy wafers for Stringy Floppy users. The instructions for 

getting the PENCIL running on your particular flavor of peripheral device, will 
be found in one of the three sections below. 

MODEL I and MODEL III TAPE LOADING INSTRUCTIONS 

You will notice that there is a MODEL I and MODEL III version of the program on 
each side of the cassette* The programs on each side of the tape are identical 
but each is recorded at a different baud rate* The MODEL III side is recorded at 
1500 baud and the MODEL I side is recorded at 500 baud. 

Each side of the tape contains two copies of the program about ten seconds 
apart, By playing the tape without the computer connected you may listen to 
the recording and determine the counter setting prior to attempting a LOAD, 

Load the program tape using the SYSTEM command. Type "SYSTEM 11 and press <ENTER>. 
A star and question mark will appear (*?)* Prepare the tape and recorder to load 
the tape. Type the program name, which is PENCIL. When the <ENTER> key is 
pressed, the cassette will start running. 

When the main program is reached on the tape, two stars will appear in the 
upper right of the screen. The right hand star will blink approximately every 4 
seconds. If a tape error is detected, the left star will be replaced by a "C", 
indicating a checksum error, and the machine will usually hang up. This requires 
that you press the reset button to regain control of the keyboard. When a 
successful load is achieved, THE ELECTRIC PENCIL will now start running and you 
will see THE ELECTRIC PENCIL "billboard" on the video screen. 



IM CASE OF DIFFICULTY 

If your tape fails to load, first make sure the tape is recorded. If you cannot 
hear your tapes while they are loading, pull out the earphone plug and listen. 
Write down the tape counter settings where the sound begins and ends, There is 
a second copy of the program on each cassette* which starts about ten seconds 
after the end of the first copy. Be sure to write down the numbers on the 
counter, for both copies. 

Nearly all tape loading difficulties can be resolved by adjusting the volume 
Control on your tape recorder* Tapes usually load reliably using the Radio Shack 
CTR41 or the CTR8QA recorder with the tone control in the high position and the 
volume control set between 6 and 7 1/2. Start with your control set for 7 1/2. 
If this doesn't work, try lowering the volume control by about 1/4 number 
division on the volume dial. Continue this procedure until you are able to load 
the tape. Level II tapes are very touchy; a change of 1/4 division in volume 
settings, can make a major difference in performance* 

Usually volume control problems show up very quickly* This procedure should 
not take too long. Experiment with your tape and when it loads, write down the 
setting on the cassette label. Be sure to try both copies before giving up. If 
you are unable to load either copy of your program at any volume level, flee 
APPENDIX III for replacement procedures. 
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t.i»Cr ^ ? y ° Ur U ? e recorder s ° that you can hear it during record or 
playback operations. It is a simple matter to place a resistor (about 100 ohms; 
experiment to determine the proper volume level) across the speaker disable 
switch on the jack plug, inside the recorder. You will then be able to iudse the 
proper volume level for your tapes, be able to tell when the tape starts and 
ends, and can sometimes hear a tape "dropout" problem when it occurs. 

STRINGY FLOPPY LOAD ING IK STRUCT TfiNR 

There are two ELECTRIC PENCIL programs recorded on the EXATRON STRINGY FLOPPY 
wafer. They are identical and are file numbers "1" and "2". The second recording 
is a "backup" copy of the first. 

Before we can LOAD or SAVE programs and text on the Stringy, it has to be 
initialized so that the computer knows that it is out there, on the end of some 
cable. The initialization will also allow the computer to recognize the 
Stringy s commands. 

Make sure your system is on and all of the peripheral devices are on. If you 
have a disk system, load "BASIC" from the "DOS READY" message. If you have a 
LEVEL II system, then you are already there. 

Now, from BASIC'S "READY" message, type: 

SYSTEM <ENTER> 
and the computer will display: 
*i 

enter the following: 

*? /12345.<ENTER> 

and now you will have the EXATRON Stringy Floppy initialization message 
displayed on your screen like so: 

EXATRON STRINGY FLOPPY VERSION 4.1 

Now, load the EXATRON STRINGY FLOPPY wafer that contains THE ELECTRIC PENCIL 
program into the Stringy Floppy drive and type: 

@LOADl <ENTER> 

When the EXATRON STRINGY FLOPPY has completed its load, PENCIL will 
^»2??5 1C ^ ly begin runnin S» The screen will clear and you will see THE ELECTRIC 
SSSi S blUboa f d message. Now skip over the next few paragraphs to the 
"GETTING STARTED" part of this book. (Do not pass "GO", do not collect $200 ) If 

FYiT^r c^™^ l0adinS £Ue number ° ne ' tr y file number two on the same 
EXATRON STRINGY FLOPPY wafer and check all of your hardware for proper 
operation. (I have found the EXATRON STRINGY FLOPPY an extremely reliable 
device and have found most errors to be my fault and not those of the system. - 
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DISK LOADING INSTRUCTIONS 

There are several program files on the distribution diskette. They are: 

PENCIL/CMD - THE ELECTRIC PENCIL initialization file. 

PENCIL01/SYS - An ELECTRIC PENCIL system file. 

PENCIL02/SYS - An ELECTRIC PENCIL system file. 

FENCIL03/SYS - An ELECTRIC PENCIL system file, 

XFER/CMD - A special transfer program 

Only the "PENCIL" files are "necessary" files. The "XPER/CMD file is for 
transferring the Pencil files on two drive systems. Tape and Stringy Floppy 
versions of THE ELECTRIC PENCIL are a single program and do not have the same 
program structure as the disk version. 

ALL DISK DRIVE SYSTEMS 

Turn on your computer and all of the peripheral devices such as disk drives and 
printer. Prepare a SYSTEM DISK with DOS on it (to put your ELECTRIC PENCIL 
master program files onto) by making a BACKUP copy of your DOS and KILLing ALL 
unnecessary files on the backup copy of the diskette. This diskette will become 
your MASTER diskette with THE ELECTRIC PENCIL program on it. 

TRS-DOS users refer to the "BACKUP" command and NEWDOS users refer to the 
"COPY 11 command for making a duplicate diskette. 

SINGLE DISK DRIVE SYSTEMS (MODEL I SYSTEMS ONLY) 

Once you have prepared your MASTER SYSTEM DISKETTE, remove it from the disk 
drive and insert THE ELECTRIC PENCIL DISTRIBUTION DISKETTE. Press the RESET 
button. The disk drive will start and you will see the following message: 

PLACE MASTER SYSTEM DISKETTE IN DRIVE 
AMD PRESS <ENTER> 

After you have followed this instruction you will see: 

PLACE ELECTRIC PENCIL DISTRIBUTION DISKETTE 
IN DRIVE AND PRESS <ENTER> 

This process will continue until all of the files on THE ELECTRIC PENCIL 
DISTRIBUTION DISKETTE have been transferred to your MASTER BACKUP DISKETTE. 
Remove the disk from the drive and place a WRITE PROTECT tab over the square 
notch, on the side of the diskette. Now, with the MASTER BACKUP disk in the 
drive* press the RESET button and when the DOS READY messages appears make a 
WORKING DISK from your MASTER DISKETTE. 

Be sure that you WRITE PROTECT this diskette and file it away in a safe 
place. Then if something happens to your WORKING DISK, you will always be able 
to make a new copy. 

Place your WORKING DISK into the drive and now you are ready to RUN THE 
ELECTRIC PENCIL. From the DOS READY message type: 

PENCIL <ENTER> 

The next thing you will see is THE ELECTRIC PENCIL'S billboard message on your 
screen. You are now ready for the "GETTING STARTED" chapter on page 14- 
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SINGLE DRIVE SYSTEMS - (MODEL TTT systems 1 

THE ELECTRIC PENCIL is distributed on single density, 35 track, Model I 

Mo^? t TT? lS ^ tte8 i ° nly ' Sin " th " e is n0 single drive C0NVERT P r °g^ for the 
Model III, the only way to copy your programs to a Model III single disk system 

is to have a friend with a two drive system make the transfer for you. We 
apologize for this unfortunate inconvenience, but the complexity of supporting 
every configuration f two machines of several disk operating systems is just 
not Dossiblc. ■* 



not possible. 



MDLTIPLE DRIVE SYSTEM S (MODEL I ONLY) 



drtvv 7 <7- haVe P reP ^ ed y ° Ur K4STER SYSTEM WSKETTE, insert it into the SYSTEM 
DRIVE (drive zero). Place THE ELECTRIC PENCIL DISTRIBUTION DISKETTE into drive 
one. From the "DOS READY" message type: 



XFER <ENTER> 

THE ELECTRIC PENCIL will be transferred from the distribution diskette on drive 
one to your MASTER DISKETTE on drive zero, without any further action on your 
mIsTER MSKETTe! traQSfer Pr ° CeSS " com P let ^ *ake a WORKING DISK from your 

Be sure to WRITE PROTECT this diskette and file it away in a safe place. Then 
if something happens to your WORKING DISK, you will always be able to make a new 
copy. 

ELvlltrr JSpt? "?™ ?J S V Qt ° the driVS 2er ° aQd y ° U are now read y t0 R ™ THE 
ELECTRIC PENCIL. From the DOS READY message type: 

PENCIL <ENTER> 

The next thing you will see is THE ELECTRIC PENCIL'S billboard message on your 
screen. You are now ready for the "GETTING STARTED" chapter on page 14. 

MULTIPLE DRIVE SYSTEMS (MODEL III) 

p*Jtt *°? ^ e USlnS IRSD0S » USe the C0N VERT utility to transfer all of the 
rw^lL tiles from drive one to drive zero and KILL the XFER/CMD file, on drive 
zero, as it is not used on the Model III 

th/pJ™/" U8i ! 8 ™? S 'J°» "define drive one as a single density drive with 
tde PDRIVE command and simply copy the ELECTRIC PENCIL files to drive zero Tvoe 
the following PDRIVE parameters: yP 

PDRIVE,0,1,TD=A,SPT=10 <ENTER> 

Do not forget to reset your PDRIVE parameters to TD=E and SPT=18 for double 
density operation. 
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GETTING STARTED RIGHT NOW! 



If you are an old hand at the "THE PENCIL" and have a good working knowledge 
of the computer and word processing, chances are that you don't want to wade 
through this book to find out every new feature - you want to get up and running 
right now and learn about the bells and whistles later. 

It is assumed that anyone reading this section is familiar with the computer 
and how to load and execute programs so we have not included the steps 
concerning the details of these operations. Any questions, so far? 

"What's different about this release of THE ELECTRIC PENCIL and previous 
releases?" 

Glad you asked about that - as far as the general operation is concerned, very 
little. None of the text entry commands have been altered in their functions but 
a few, those which were also assigned to other keys, such as control-w for 
up-arrow and control-m for the "ENTER" key, for instance, were simply deleted. 

The SYSTEM MENU has been changed quite a bit. The system commands are now 
displayed and the print commands have been put into their own menu, the PRINT 
MENU which is entered with the command <CONTROL>-<P>. 

All of the file handling commands have been changed to their normal- every- day 
TRS^SO type commands. "DL", disk load, is now just plain "LOAD" and tape read, 
formerly "R" is now "CLOAD". Since all of the commands are displayed in logical 
groups you will not have any trouble finding the command you want to use. 

The PRINT MENU has some new innovations that will make setting up your print 
formatting a breeze. Once again, we grouped all of the functions together that 
had the same logical purpose. The format commands are on the left, the printer 
control commands on the right and the active print driver below. The print 
commands have been changed to two letter commands with the initials of the 
command as the actual command, "PL" is page length and "PS 1 * is page spacing, for 
example. All of the commands are displayed so you can find what you are looking 
for without referring to this manual. 

We have removed the limitations on print values and have made all the printer 
control settings so they can be reset once they have been set. For those of you 
with serial printers, you can now set your R£232c UART and TRS-232 settings from 
within the PRINT MENU. Baud rates now include all of the standard settings from 
110 to 9600 baud. 

If you get stuck on anything, you can get specific answers from this manual. 
Besides the table of contents, there are 3 sub-contents pages that cover the 
three main sections; 

TEXT ENTRY page 17 

SYSTEM MENU page 47 

PRINT MENU page 68 

A quick reference to these sub-contents pages will point you to the exact page 
that will answer any questions you have about any particular command. You will 
also find a QUICK REFERENCE CARD as the very last page of this manual. Of 
course there is additional information that you should be aware of but, you can 
get around to that at your leisure. You will also notice that THE ELECTRIC 
PENCIL is "bullet proof" - it is virtually impossible to cause a "blow it up" or 
"hang" as a result of anything you enter, load from disk, tape or stringy once 
the PENCIL is running. Now let's get going. 
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DISK USERS: 

1. Transfer the programs on the distribution disk 
onto a system disk. (If you have a one drive system, 
you can refer to page 10 for the procedure*) 

2. Boot the system disk with the PENCIL programs on 
it and from "DOS READY 11 type: PENCIL<ENTER> 

3. Go to the paragraph titled "RUNNING", below. 

TAPE USERS 

1. Make sure everything is connected and set. 

2. From BASIC'S "READY" mode, type: SYSTEM<ENTER> 

3. From the prompt, "*?" type: FENCIL<ENTER> 

4. The tape will begin loading. If you have trouble, 
refer to page 8. 

5* Go to the paragraph titled "RUNNING", below. 

STRINGY FLOPPY USERS, 

1. Insert the wafer into your Stringy Floppy drive. 

2 . Make sure the Stringy Floppy has been initialized 
with the Tl /12345" command. 

3. From BASIC'S "READY" mode, type: @L0AD1<ENTER> 

4. Go to the paragraph titled "RUNNING", below. 

RUNNING 

At this point you have THE ELECTRIC PENCIL'S billboard message on the screen. 
Press any key. The billboard will disappear and a solid white cursor will appear 
in the upper left corner of the video display. As soon as it starts to flash, in 
a second or two, you may start entering your text. 

Each key you press will appear on the display the instant you press the key. 
When you reach the end of a line on which a word will not fit in its entirety, 
the word will be shifted down to the next line. 

DO NOT press the <ENTER> key until you get to the end of a paragraph or wish to 
make a blank line. 

Editing of the text is accomplished by pressing the control key (CLEAR) and the 
appropriate letter key AT THE SAME TIME. A list of the CONTROL functions are on 
page 17 and the QUICK REFERENCE CARD. 

To save the text to tape, wafer or disk, go to the SYSTEM MENU by pressing 
CONTROL-K (the control key is the "CLEAR 1 * key). Issue the proper save command 
for tape, wafer or disk. 

CAUTION: the text will be SAVED from the cursor position to the end of the file. 
Any text preceding the cursor will NOT BE SAVED1 

™J^ LDt tbe file ° n your liue P rin ter, go to the PRINT MENU by pressing 
CONTROL- P. Press the <ENTER> key and the text will immediately be printed. To 
print more than one copy of a file on the printer, enter the number of times you 
wish to print and then press <ENTER>. 

Remember, this section is not MEANT to be a complete instruction course for THE 
ELECTRIC PENCIL. Its purpose is to get those of you who have enough knowledge 
about the computer and THE ELECTRIC PENCIL up and running as fast as possible 
with as little instruction as possible. 
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GETTING STARTED 



When you have successfully loaded THE ELECTRIC PENCIL and the program is 
running, the screen will clear and THE ELECTRIC PENCIL'S billboard message will 
appear, 

figure 1 
NORMAL PROGRAM OPERATION 

Press ANY key and the billboard message will disappear and a flashing white 
cursor will appear in the HOME or upper left hand corner of the screen. 

A text file may now be started by typing your text. If you have the lowercase 
kit installed (or a MODEL III machine) type <SHIFT>-<BREAK> or <SHIFT>-<J0f> to 
turn on the lowercase. A second <SHIFT>-<BREAK> or <SHIFT>-<#> will toggle 
(meaning to switch from one mode to another) the keyboard to uppercase only. Any 
key, after being held down for about 1/2 second, will repeat at a rate of about 
ten characters per second with the SYSTEM MENU. 



Type in the following text: 




The cursor is now at this positio 



Press the <SPACE BAR> and continue typing; 




When you typed, "reason" you would have seen THE ELECTRIC PENCIL shift the word 
down to the next line. This is because it would not fit onto the line we were 
currently working on. This makes the text easier to read and work on. If THE 
ELECTRIC PENCIL did not do this, the text would be VERY hard to read. You also 
noticed, no doubt, that we did not have to press the <ENTER> key when we reached 
the end of the line. 

Now, continue typing in this text. DO NOT PRESS <ENTER> UNTIL YOU SEE THE 
INSTRUCTION TO DO SO! We'll use this file later on to demonstrate some of the 
features of THE ELECTRIC PENCIL. 
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When you get to this point, press the <ENTER> key and 
the "carriage ret urn" symbol will be placed here. 



The cursor will position itself 
_here. ready to start a new line t 



Note that <ENTER> is not used at the end of each line and that any partially 
completed word that would not fit on the line, was brought down, to the next 
line and a new line was started* 

Typing proceeds normally until the end of a paragraph is reached* At this 
point, <ENTER> is used to terminate the paragraph or record. A left-arrow (<-) 
appeared on the screen at the end of the line, and the cursor advanced to the 
beginning of the next line. Any additional <ENTER>s will insert blank lines 
after the paragraph. 

If this is to be the end of a PRINTED page, and you do not want the program 
to wait until the page length parameter (PLnn) is reached, you may FORCE a FORM 
FEED by entering a <SHIFT>-<t>. Your text will look like this: 




This is the FORM FEED character. 
(A diamond on MODEL III machines.) 



The FORM FEED will cause the printer to eject one page and start a new page. On 
a MODEL I computer this is a down arrow, as shown and on the MODEL III it is a 
diamond character (♦). 

Whenever a specific number of spaces within a line are essential, the line 
must be terminated by an <ENTER>. This is because lines are not delineated and 
may be broken up at any point during printing. Exactly where a line will end is 
determined by the line length that you select prior to printing. 

Experimentation and imagination will bring about almost any desired results in 
the final printing of text. 
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THE ELECTRIC PENCIL OPERATING INSTRUCTIONS 

THE ELECTRIC PENCIL has three modes of operation. The first is the TEXT ENTRY 
mode, the second is the SYSTEM MENU mode and third is the PRINT mode. 

In the TEXT ENTRY mode you will be able to enter, edit, and move the text* 
From the SYSTEM MENU you can SAVE and LOAD text files to tape, Stringy Floppy 
wafer or diskette, depending on your system. You will also be able to determine 
the amount of free memory you have left, the number of words you have used, 
selectively clear text from memory and set the cursor speed. 

In the PRINT mode you may set the PRINT VALUES, select the printer output 
ports and cause the file to be printed on the line printer any number of times. 

The TEXT ENTRY mode is entered immediately after you press any key while THE 
ELECTRIC PENCIL'S "billboard" message is displayed. Text may be entered as soon 
as the flashing cursor appears. Cursor control, editing functions, special 
characters, utility functions and special purpose functions are entered by 
pressing the "control" key and a letter key or the "shift" key and a letter key, 
depending upon the exact function desired. 

The operation of the program is simple and straight forward. It performs as 
you would expect it to. When you press the up- arrow key, the cursor moves up. It 
does NOT move out of its track, or go to the beginning of the line; it moves as 
you would expect it to; up. The <BREAK> key will "break", "abort" or "halt" any 
operation or function. There is NOT one key that will "break" some functions and 
another key to "break" others. One simple keystroke does it all. 

The commands are as simple as possible and require as few key strokes as 
possible. The commands, issued from the menus, use a mnemonic (a word meaning 
"memory aid" - see GLOSSARY) that corresponds to the device or function. For 
instance, CLOAD, CSAVE and CLOAD? arc the normal TRS-80 mnemonics used to 
"read", "write" and "verify" cassette tapes. THE ELECTRIC PENCIL uses these same 
mnemonics. Mnemonics for the PRINT MENU functions use the first letters of the 
function's name for its mnemonic. LINE SPACING is LS» CARRIAGE RETURN ON/OFF is 
CR, RIGHT JUSTIFY is RJ, and so on. The number of things you are required to 
remember is very small. In fact, you could say that if you know what you want to 
do, you know the command, i.e., to Set the LINE LENGTH to 70 characters the 
command is : LL70 • 



RECOVERING FROM AN ACCIDENTAL EXIT 

It is possible to re-enter THE ELECTRIC PENCIL after an accidental exit or 
"boot", providing the program code and file area is undisturbed. 

TAPE and STRINGY FLOPPY SYSTEMS: THE ELECTRIC PENCIL'S restart address is 5BA0 
hex; 23456 decimal. From level II BASIC, type: SYSTEM <ENTER> 

The computer will respond with: *? Now type: / 23456 <ENTER> 

You will immediately re-enter ELECTRIC PENCIL'S text input mode. If "garbage" 
appears on the screen or the computer "hangs", then the memory was "zapped 11 and 
you will have to restart the program and re-enter the text. 

DISK SYSTEMS: THE ELECTRIC PENCIL disk systems have a built-in "restart 
utility". From the "DOS READY" mode, type: PENCIL * <ENTER> 

If the program is able to restart, you will return to the "billboard" message. 
Press any key to return to the text input mode. If the program is unable to 
restart a message will appear* If the tape and Stringy Floppy versions will not 
restart you will have a program "hang" or "garbage" will appear on the screen. 
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TEXT ENT RY MODE COMMANDS AND THEIR FUNCTIONS 

Control Character Commands require that the CONTROL key (CLEAR for MODEL III 
and unmodified MODEL I machines) AND the specified alphabetic character key be 
depressed AT THE SAME TIME! Control Characters vill not appear ou the video 
display. Special characters generated by pressing control keys, such as the 
underline character, form feed, and carriage return character, will appear on 
the display. er 

The TEXT ENTRY mode commands are grouped into 5 groups; (1) The Cursor 
Control Functions, (2) Editing Functions, (3) Utility Functions, (4) Special 

th^TEXT fn^y"^ ^ ^ SpeClal Charact « s ' The Allowing table is a list of 
tfte TEXT ENTRY mode commands and functions. 



COMMAND TYPE 



COMMAND 



FUNCTION 



CURSOR 

CONTROL 

FUNCTIONS 



UTILITY 
FUNCTIONS 



SPECIAL 
PURPOSE 
FUNCTIONS 



SPECIAL 
CHARACTERS 



PAGE 



<■"•"> CURSOR LEFT 18 

<-*-> CURSOR RIGHT 19 

< + > CURSOR UP 2 

<t> ■• CURSOR DOWN 21 

<CTL>-<Q> CURSOR HOME 22 

<CTL>-<N> CURSOR to FILE END 2 3 

<CTL>-<B> CURSOR to FILE BEGINNING 2 4 

<CTL>-<E> SCROLL UP (forward) 25 

<CTL>-<X> SCROLL DOWN (backward) 25 

<SHIFT>-<CLEAR> CURSOR TO BEGINNING OF LINE .... 26 

<SHIFT>-<-*-> TAB RIGHT 8 SPACES 2 7 



<CTL>-<D> DELETE CHARACTER 28 

<CTL>-<F> or <CTL>-<I> . INSERT CHARACTER 2 9 

<CTL>-<Y> DELETE LIHE 30 

EDITING <CTL>-<G> INSERT LINE 31 

FUNCTIONS <CTL>-<T> ERASE to END of LINE .......,„! 32 

<CTL>-<U> DELETE BLOCK 33 

<CTL>-<H> INSERT BLOCK 33 

<SHIFT>-< + > BLOCK MARKER CHARACTER 34 

<SHIFT>- <-«-> BACKSPACE £. ERASE 35 



<CTL>-<V> STRING SEARCH 39 

<CTL>-<C> CONTINUE SEARCH 40 

<CTL>-<R> REPEAT FUNCTION 42 

<CTL>-<K> SYSTEM MENU 43 

<CTL>-<P> PRINT MENU 43 



<BREAK> ABORT & EXIT CURRENT MODE 44 

<CLEAR> "CONTROL" KEY 44 

<SHIFT>-<0> UPPER/LOWER CASE LOCK ] 44 

<SH IF T>-< BREAK > UPPER/LOWER CASE LOCK 44 

<SHIFT>-<ENTER> DICT-A-MATIC ON/OFF 44 



<SHIFT>-<+> FORM FEED 3$ 

<ENTER> TERMINATE RECORD (line feed) ... 36 

<CLEAR>-<0> UNDERLINE CHARACTER 36 

<CTL^<SPACE> HARD SPACE CHARACTER 37 

<CTL>-<-*-> CONCATENATE CHARACTER 38 



Special SEARCH & REPLACE characters (see pages 39-41): 

<SHIFT^<-*-> <ENTER> CHARACTER 

<SHIFT>-< + > FORM FEED CHARACTER 

<CTL>-<-«-> "WILD CARD" CHARACTER 

<CTL>-<-*-> "NULL" CHARACTER 
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CURSOR CONTROL COMMANDS 

If you hold down a cursor motion key (or any other key), it will begin to repeat 
at about ten characters per second after a half second delay. This feature may 
be used to rapidly position the cursor anywhere on the screen. The repeat 
function rate can be set to as high as 34 characters per second with the CURSOR 
SPEED command, from the SYSTEM MENU. 

CURSOR LEFT <-«■> 

Pressing the <-*■> key will cause the cursor to move from right to left. 



With the cursor here, pressing 
<-*-> will cause it to,.. 



....move to here 




When moving the cursor to the left, its movement will continue to the end of the 
line above it when it encounters the beginning of the current line. If text 
exists above the top line of the display, holding the left arrow key will cause 
the text to scroll down one line before the cursor wraps up to the end of the 
next upper most line. This action will continue until the beginning of the file 
is encountered. Cursor motion is as depicted below: 
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CURSOR RIGHT <->»-> 

Pressing the <-*-> key will cause the cursor to move from left to right, 



With the cursor here, pressing <-*-> 
will cause it to T , . 



3 . . .move to herp 




When moving the cursor to the right, its movement will continue to the beginning 
of the Ixne below it when it encounters the end of the current line. If text 
exists below the lower most line of the display, holding the right arrow key 
will cause the text to scroll up one line before the cursor wraps down to the 
beginning of the next lower most line. This action will continue until the end 
ot the file is encountered. Cursor motion is as depicted below: 
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CURSOR UP < I > 

Pressing the < 4 > key will cause the cursor to move upward, toward the top of 
the file. 



With the cursor here* pressing <T> will cause it to.., 
...♦move to here 




When moving the cursor up, its movement will continue until the cursor 
encounters the top line of the display . At that time, if text exits above the 
upper most displayed line, the text will be scrolled down (effectively moving 
the cursor up) through the text. This action will continue until the beginning 
of the file is encountered. The cursor will move vertically in the same "track" 
or column. 
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CURSOR DOWN < t > 

Pressing the <t> key will cause the cursor to move downward, toward the end 
of the file. 



With the cursor here, pressing 
<t> will cause it to Tt T 

«_».move to here 




When moving the cursor down, its movement will continue until the cursor 
encounters the bottom line of the display. At that time, if text exits below the 
lower most displayed line, the text will be scrolled up (effectively moving the 
cursor down) through the text. This action will continue until the end of the 
file is encountered. The cursor will move vertically in the same "track" or 
column. 
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CURSOR HOME 



<CTL>-<Q> 



Pressing the <CTL> key and the <Q> key will cause the cursor to move to the 
upper left corner of the video display. 



With the cursor here, pressing 
<CTL>-<0> will cause it to,.. 



....move to here 




The cursor may be at any position on the screen. This command does not cause the 
text that is displayed to be scrolled or moved in any way. 
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CURSOR TO FILE END <CTL>-<N> 

Pressing the <CTL> key and the <N> key will cause the cursor to move to the 
end of the file. If the file has more text than will fit on the video display, 
the screen will appear blank - simply press the < | > key and the text will 
scroll down into view. 




Press <CTL>-<N> 



The file will move, 
in the display, from 
here. .. 



File 



•••to here. 



Press the <4> key 
and the text will 
scroll into view. 
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CURSOR TO FILE BEGINNING <CTL>-<B> 

Pressing the <CTL> key and the <B> key will cause the cursor to move to the 
beginning of the file. 



i tUli TILL HllfLt 




,to here. 



File 



,t ih, b«t l4i n ^n tin 



, Ai LJk. ii *ou TILL ri 



'* IM %t*l* lK.t> 




Press <CTL>-<B> 

The file will move, 
in the display, from 
here... 
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SCROLL UP 



,<CTL>-<E> 



Pressing the <CTL> key and the <E> key will cause the text file to SCROLL 
upward. 

SCROLLING is the action of the text moving up or down the video display. 
More than 16 lines of text (one page) must exist in the file for this action to 
occur. The cursor will disappear from the screen during a scroll. 



SCROLL DOWN 



<CTL>-<X> 



Pressing the <CTL> key and the <X> key will cause the text file to SCROLL 
downward. 



SCROLLING CONTROL 

Scrolling speed may be controlled by typing the numerals <1> through <5> WHILE 
scrolling. <1> i s the fastest speed, and <5> is the slowest. 

Further control is provided by the <SPACE BAR>, which temporarily halts the 
scroll. Continued pressing of the <SPACE BAR> will scroll one line at a time in 
the direction selected. 

The <ENTER> key will continue the scroll after it has been halted by the 
<SPACE BAR>. ^ When the end of the file is reached or when <BREAK> is pressed, 
the scrolling will stop and the cursor will reappear on the screen. 



SCROLL SPEED CONTROL 

1 - Fast 

2 = Medium Fast. 

3 = Medium 

4 = Medium Slow 

5 - Slow 

SCROLL COMMANDS 
<SPACE BAR> = Freeze Scrolling. 
<SPACE BAR> - Scroll 1 line in 

direction selected. 
<ENTER> = Continue scroll 

after freeze. 
<BREAK> = Abort scrolling at 
current position. 




* 



I 



Scroll up 
CTL>-<E> 



Scroll down 
<CTL>-<X> 
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CURSOR TO BEGINNING OF LINE <SHIFT>-<CLEAR> 

Pressing the <SHIFT> key and the <CLEAR> key will cause the cursor to go from 
its present position on a line to the beginning of that line. 



With the cursor here, pressing 
<SFT>-<CLEAR> will cause it to,.. 



,,,,move to here 




The cursor may be at any position on the line. 
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TAB RIGHT 8 SPACES <SHIFT>-<-»-> 

Pressing the <SHIFT> key and the <->-> key will cause the cursor to tab to the 
right eight spaces. It may be used as an "express" key to quickly move across 
the screen as well as for its normal function of tabbing 8 spaces to the right. 



With the cursor here, pressing 
<SFT>-< ^> will cause it to r - T 




When moving the cursor to the right, its movement will continue to the beginning 
of the line below it when it encounters the end of the current line. If text 
exists below the lower most line of the display, holding the tab right keys will 
cause the text to scroll up one line before the cursor wraps down to the 
beginning of the next lower most line. This action will continue until the end 
of the file is encountered. Cursor motion is as depicted below: 
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EDITING COMMANDS 



DELETE CHARACTER 



<CTL>-<D> 



<CTL>-<D> is used to delete a character from the text. The cursor is placed over 
the character to be deleted and <CTL>-<D> is typed. The entire text then moves 
towards the cursor one position. Multiple deletions are also possible from any 
location by deleting one character or space at a time. 



With the cursor here, pressing 
<CTL>-<D> will cause ... 




.••the text on the current line to move back 
one space. 




If you continue to hold down the <CTL> and <D> keys, letters will continue to be 
deleted and all of the text will be moved up to compensate for the deleted 
letters. 
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INSERT CHARACTER <CTL>-<F> or <CTL>-<I> 

The Electric Pencil is normally in an "over-write 11 mode. This means that any 
character typed will appear wherever the cursor is located. If there is a 
character at the current cursor position, the new character typed will replace 
the existing one. By typing <CTL>-<F> or <CTL^<I>, the INSERT mode is entered. 
The size of the cursor will increase to warn you that the system is now in 
INSERT mode. While in the INSERT mode any character typed will automatically 
shift the entire text to the right and insert the new character at the cursor 
position. 

Typing <BREAK> or <CTL>-<F> or <CTL>-<I> while in the INSERT mode or 
leaving the current line will exit the INSERT mode and the cursor will assume 
its normal form. When the end of a line is reached while in the INSERT mode (or 
even while in the normal over-write mode), an entire line will be opened up to 
allow for additional character insertion. If a line is only partially filled, 
<CTL>-<D> will pull up the rest of the text to the cursor. 



With the cursor here, pressing <CTL>-<F> or 
<CTL>-<I> will change the cursor size and 
place the program into the INSERT mode. 




Now with program in the insert mode type: XXXXX 
The text will look like this: 




Notice that the text is shifted down when the last word, of the line, will no 
longer fit onto the line we are performing the insert function upon. 
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DELETE LINE 



<CTL>-<Y> 



<CTL>-<Y> will delete whatever line the cursor is currently on» The text below 
the deleted line will be moved up one line. 



With the cursor here, pressing 
<CTL>-<Y> will cause the current... 




...line, that the cursor is on, to be deleted and the 
text that is below the current line, to be moved up one line 




The cursor may be at any position on the line. When the 
cursor position will not be changed. 



line is deleted, the 
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INSERT LINE 



<CTL>-<G> 



<CTL>-<G> will move the line that the cursor is currently on down one line. The 
cursor will position itself at the beginning of the empty line you have just 
created. Text may now be typed in as needed. When the end of the line is 
reached, another <CTL>-<G> will automatically be entered by the system, allowing 
you to continue entering text without interruption. 

If you move the cursor off the "insert line", the text will be moved up next 
to the text you have entered. 



With the cursor here, pressing 
^CTL>-<G> will cause the current 




...line to be moved down and the cursor to go to the 
beginning of the new line T 




VFhtlH t^t'B 






Once you have opened up a "new line", THE ELECTRIC PENCIL will continue in the 
new line" mode. Each time you fill a line, a "new line" will be opened up until 
you press <ENTER> or move the cursor off the line and then the text will be 
moved up, next to your new text. 
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ERASE TO END OF LINE <CTL>-<T> 

<CTL>-<T> erases all text from the current cursor position to the end of the 

current line. 



With the cursor here, pressing 
will cause, .» 




...the current line to be erased from 

the cursor position to the end of the line. 




Only the text AFTER the cursor, on the current line is affected. 
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DELETE BLOCK 



<CTL>-<U> 



<CTL>-<U> will delete a block that has been correctly marked as stated below 
The block markers are deleted during this action. If a block is incorrectly 
marked or not marked at all, "MARKER ERROR" will appear on the video display 



BLOCK MOVEMENT of TEXT 

A "block" is any amount of text as small as one character or as large as an 
entire file. It may be a word, a sentence, a paragraph or a group of paragraphs. 
To move a block of text from one part of the file to another part of the file 
or to delete a block of text, it must first be MARKED. The character used to 
mark the boundries of a block is a graphic character in the form of a vertical 
bar. This character is also called a "marker". 

To mark the boundaries of a block, the cursor is placed over the first 
character of the block of text you want to MOVE or DELETE and then the <SFT>-<4> 
keys are pressed. The action will be the same as if the INSERT Mode was entered 
and the text on that line will be shifted right one space and the MARKER will 
appear. 

Move the cursor one character beyond the end of the block of text you wish to 
move or delete and again press the <SHIFT>-<4> key. Now you have marked the 
beginning and end of the BLOCK. The text between the two MARKERS may now be 
moved or deleted. Exactly two markers must be used - otherwise, a MARKER ERROR 
message will appear on the video display when a move or delete is attempted. 

<BREAK> is used when this error occurs to return to the text input mode so 
you may eliminate the extra markers or put in one you have forgotten. Markers 
may be deleted by using the SEARCH and REPLACE function or the DELETE CHARACTER 
function. 

When you use the markers to delete a BLOCK of text, the markers themselves 
are automatically deleted along with the text. 



NOTE 



Markers should not be placed after an <ENTER> char- 
acter on the screen. Instead, place the marker at 
the beginning of the following line. This will pre- 
vent the appearance of two markers on the screen. 



INSERT BLOCK <CTL>-<H> 

<CTL>-<H> is used to insert a correctly marked block at any selected cursor 
position and may be repeated as often as desired. "MARKER ERROR" will appear on 
the video display if an attempt is made to move a block into itself or if more 

° r JlL thaU tW ° markers exist in the f^e. See above for additional information 
on BLOCK MOVEMENT of text. 
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INSERT & DELETE BLOCK EXAMPLE 

Move the cursor here and press 
<SFT>-<4> # The marker character will 
appear and move the text one place 
the right, 



Repeat the marking procedure here. 




Now, move the cursor to here and press the 
<CTL>-<H> keys and the text will look like this, 




coHunicau ^ 










Try pressing the <CTL>-<E> combination a number of times and see what happens.^ 
Move the cursor to the middle of the text and try it. Magic, huh? 

You may insert a block anywhere in the text EXCEPT within the MARKED block 
itself. You may make as many insertions as you need, or until you have filled up 
your memory. The <CTL>-<R> (repeat) function can also be used to repeat a block 
any number of times. 



To delete the MARKED BLOCK press the <CTL>-<U> keys. The marked block AND the 
markers will disappear from the file. 
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BACK SPAC E & ERASE CHARACTER <SHIFT>-<-«-> 

This will cause the cursor to move from left to right and each character the 
cursor is moved over will be erased. 



With the cursor here, pressing 
<SFT>-<^> "11 ... 




...backspace and erase. 
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SPECIAL CHARACTER KEYS 

FORK FEED <SHI]FT>-< t > 

A FORM FEED is used to terminate a paragraph or "record 11 and start a new page. 
When it is encountered during printing, the printer will advance the paper to 
the top of the next page. The FORM FEED character will appear as a down arrow 
character (^) on the MODEL I and as a diamond character (♦) on the MODEL III. 

TERMINATE A PARAGRAPH OR RECORD <ENTER> 

<EKTER> is used to terminate a "record" or paragraph or to place an empty line 
between records, When <ENTER> is typed, a left-arrow will appear at the cursor 
position and the cursor will advance to the beginning of the next line. 

NOTE: On some printers, such as the Centronics 779, you must precede a blank 
line with a space or the printer will ignore your blank lines* 

UNDERLINE CHARACTER <CTL>-<fl> 

Since the TRS-80 does not have an underline character built into the keyboard, 
it is necessary to generate it by typing some special control code. <CTL>-<jEf> 
will generate the underline character just as if it had its own special key. 
Also see UNDERLINING below for a complete explanation of the use of 
underlines, 

CONTROL KEY <CLEAR> or <CTL > 

This^ key has no function of its own. It must be used with another key in order 
for it to have any special function. On modified MODEL I computers that have a 
special control key installed, BOTH the <CLEAR> key and the <CONTROL> key have 
exactly the same function; i.e. you may use either one if both are installed 
with exactly the same results. 
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HARD SPACE CHARCTER <CTL>-<SPACE> 

The hard space is used to prevent the ELECTRIC PENCIL from adding spaces 
between words when printing justified text. The hard space character itself, 
does not print. On the video display it is handled as another input character 
and on the printer it is handled as a space character. On the video screen the 
hard space character is a graphics character that looks like this: 



1 



Character 176 



It is also useful for formatting text when you need to space words or 
characters on the video display in order to achieve a desired print format. 

Here is an example of the use of the hatd space. Suppose you had the print 
values set so that the line length was 50, and right justification was "on" 
(LL50, RJ1) and had a line of text that looked like this when it was printed 
out: r 

1 . OPERATING SYSTEM - A group of programs 
But., you preferred that it looked like this: 

1. OPERATING SYSTEM - A group of programs 

Then you would use the hard space to control the print formatting. Our line of 
text would look like this on the video display: 

l-^DPERATINC^YSTEM - A group of programs 

By using the hard space character, we can guarantee that the spacing in our 
title above will be just at it appears on the screen* 

Another useful feature of the hard space is that it permits you to place a 
character on the video display that will not be printed (except as a space) and 
yet it will be "counted 11 as a character and not a space by the video. An example 
of this would be a word that is to be printed on the far right hand page of the 
paper - say in the seventieth column on your paper. The video display does not 
have seventy columns and The ELECTRIC PENCIL will not let you make seventy 
spaces as one solid line of SPACES. But, it will let you made a line of spaces 
AND characters seventy characters long. So, by using a combination of "hard 
spaces" and regular spaces, you can space over to the seventieth position on the 
screen and then type your text. It will then be printed on the far right side of 
the page. 
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CONCATENATE CHARACTER <CTT>-<-^> 

Concatenate is a fancy word meaning to "join together"* This special graphics 
character will permit you to print lines that have spaces in them so that they 
are joined together. The concatenate character looks like this: 



i 



Character 179 



The concatenate character and ALL spaces between it and the next character will 
be ignored. Here is an example of how a line to be concatenated might appear on 
the video display; 

Cone a_tenat ion character 



And here is how it will appear when it is printed: 
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UTILITY FUNCTIONS 

"STRING" SEARCH <CTL>-<V> 

In computer jargon, a "string 11 is any group of contiguous characters "strung" 
together ("contiguous" is a fancy word meaning adjacent or adjoining)* The 
SEARCH function is used to locate any string of characters that may exist in the 
file from the current cursor position to the end of the file* <CTL>-<V> will 
place you into the SEARCH mode. 

Suppose you wanted to search for a "string" of characters that looks like 
this; 

yellow dogs 

Simply type, <CTL>-<V>. The display will clear and then this message will be 
displayed; 

SEARCH FOR: 

Nov type your search string into the computer so it looks like This: 

SEARCH FOR: yellow dogs<ENTER> 

Next the computer will ask you what you want to replace it with. Since we only 
want to FIND "yellow dogs' 1 in our text and not replace it with anything, ve will 
simply press the <ENTER> key like this: 

REPLACE WITH: <ENTER> 

If we had answered this question with an entry of one or more characters then 
pressed <ENTER>, it would have assumed that you wanted to SEARCH AND REPLACE 
"yellow dogs". The next question would have been; 

HOW MANY TIMES; 

If you simply press the <ENTER> key on the "REPLACE WITH?" question, it will 
assume that you only want to SEARCH for your string and not replace it and you 
will NOT be asked, "HOW MANY TIMES?". In this first example we'll assume that 
you only want to SEARCH for a string of characters. 

The maximum "string" length that can be searched and replaced is 38 
characters. In our SEARCH only example, the first occurance of the string, from 
the cursor position forward, will appear as the top line on the video display 
with the cursor over the first character that matched the "search string". 

The search may be continued by typing <CTL^<C>. You may continue to press 
<CTL^<C> until it can no longer be found* Each subsequent "find" will also 
appear as the top line, on the screen with the cursor over the first character 
of the "search string". 

When the end of the file is reached or the string no longer exists in the 
file, this message will be displayed: 

CAN NOT LOCATE "yellow dogs" 

This function is used to quickly locate selected areas within a file. 

The SEARCH function starts from the current cursor position. If the cursor is 
moved either forward or backwards in the file the search will proceed from 
that position. 
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SEARCH a nd REPLACE a STRING 

This function is used to SEARCH for a string and REPLACE it with another string. 
The old and new strings may be of different lengths. Here is an example where 
we will replace "the" with "yellow dogs": 

SEARCH FOR: the <ENTER> 
REPLACE WITH: yellow dogs <ENTER> 
HOW KANY TIMES: 12 <EKTER> 

"12" represents the number of times that the replacement is to occur and may be 
ANY decimal number up to 65535* In the event that "the" only appears 8 times in 
the text (from the current cursor position), the screen will clear and display: 

LOCATED "the" 8 TIMES 

The actual replacement will have been made 8 times . If "the" occurs 12 or more 
times in the text, 12 replacements will be made and the cursor will return to 
the text file display. All occurances of "the" can be replaced by typing a 
number greater than the possible occurances of "the" to the HOW MANY TIMES 
question. For example: 

SEARCH FOR: Mr. Jones <ENTER> 
REPLACE WITH: Mr. Smith <ENTER> 
HOW MANY TIMES: 55555 

The system will respond with; 

LOCATED "Mr. Jones" 14 TIMES 

Assuming "Mr. Jones" appears only 14 times in the text. 

CONTINUE SEARCH <CTL^<C> 

If a SEARCH is made without a REPLACE, you may continue the search after the 
first occurance is found by pressing <CTL>-<C>. This may be repeated until the 
system can no longer find your search string. 

CONDITIONAL SEARCH AND REPLACE <CTI>-<C> 

If a SEARCH is made with a REPLACE but no value is entered in the HOW MANY 
TIMES question, the REPLACE function is "conditional". After the string is 
found, you have the option of pressing <CTL>-<C> and the "found string" will be 
replaced. Or you may move the cursor and THEN press <CTL^<C> in which case the 
it will not be replaced and the next occurance of the "search string" will be 
found. 
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"CODED" S TRING SEARCHES <CTL>-<^-> "Wild card" character 

Strings may be also located where only a certain pattern is required. Suppose 

we had a file of names and addresses of clients with a "code" prefix that looks 



like this: 

WS1234HP 

Elron T. Quirt 

99 W. Plotz Way 

New York, N. Y. 10028 

WP1235LP 

Bill Smith 

3800 Wil shire Blvd. 

Los Angeles, CA. 90016 

WS9541QM 

Whelan J. Fixlip 

1707 E. North West St. 

Los Angeles, CA. 90028 

WS6784HL 

Elmer Brown 

300 N. Vermont 

Los Angeles, CA, 90028 

SEARCH FOR: WS/f/4H <ENTER> 
REPLACE WITH: <ENTER> 

will locate Elron T. Quirt. Typing <CTL^<C> will then locate Elmer Brown. 
Note that " f " is a "don't care" or "wild card 1 ' character. This character is 
generated by pressing the <CTL>-<-<-> key combination. Using this function, a 
selected mailing list can be produced. Other uses might include lists of sales 
prospects with action dates to represent appointments, expirations, service 
dates, etc. Data can be selectively extracted from a file automatically using 
the coded string search function. 

SEARCHING SPECIAL CHARACTERS 

Special characters (such as the CARRIAGE RETURN (-+) and the FORM FEED ( f )) 
can be searched and/or replaced just like any other character* We cannot use the 
<ENTER> key to generate these characters in the SEARCH & REPLACE mode, because 
it would cause us to exit the mode. While in the SEARCH mode you may generate 
these characters as shown below: 

<SFT^<^-> will generate the <ENTER> character (-*■). 

<SFT>-< t > will generate the FORK FEED character Ct ). 

<CTL^<-<-> will generate the "wild card" character ( } ). 

<CTL>-<-*> will generate the "null" character ( ^ ). 
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SEARCHING AND REPLACING CHARACTERS WITH A "NULL" 

Some times you may want to replace a string of characters or a character with 
a "null" or no character at all. If we had a sentence that looked like this: 

Now is the time for all really good men to come to the aid of the party. 

And we wanted it to look like this: 

Now is the time for all good men to come to the aid of the party. 

We will have to replace the word "really" with a "null" in order to get our 
sentence to look like the second example* Using the SEARCH AND REPLACE function 
we would answer the questions like this: 

SEARCH FOR; really <ENTER> 
REPLACE WITH: / <ENTER> 
HOW MAJNY TIMES: 1 <ENTER> 

If the "null" character looks familiar, it is because it is the same character 
we used in the SEARCH FOR question for the "wild card" character - it serves a 
different purpose when it is used in the REPLACE WITH prompt. 



REPEAT FUNCTION <CTL>-<R>, <n>, <n>. <kev> 

Most functions or key inputs may be repeated any number of times* The following 
examples will illustrate some typical uses of the REPEAT command. 

<CTL>-<R> J <5>,<CTL>-<D> will delete 5. characters, 

<CTL>-<R>,<2> J <2>,<.> will type 22 periods. 

<CTL>-<R> > <3> > <CTL>-<H> will insert a block of text 3 times. 

The cursor will disappear whenever <CTL>-<R> is typed and will return after the 
number of repeats are performed. In the event of a typing error, the cursor 
will return and nothing else will happen. This three part command is not 
visible on the screen until you have completed the entire command key sequence. 
Pressing <BREAK> will abort any phase of the REPEAT FUNCTION. 
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SYSTEM MENU <CTL>-<K> 

Pressing the <CTL>-<K> keys will cause the program to exit the TEXT ENTRY mode 
and enter the SYSTEM MENU mode. Press <BREAK> to exit the SYSTEM MENU mode and 
return to the TEXT ENTRY mode. 



PRINT TEXT ON LIKE PRINTER <CTL>-<P> 

This command will cause the PRINT MENU to be displayed. (See PRINT MENU COMMANDS 

below.) Printing will be initiated from the PRINT MENU from the current cursor 

position to the end of the file on the line printer. 
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SPECIAL PURPOSE FUNCTIONS 



ABORT CURRENT FUNCTION <BREAK> 



You may abort ANY function or return from ANY menu by pressing the <EREAK> key. 



UPPER/LOWER CASE LOCK <SHIFT>-<)?> or <SHIFT>-<BREAK> 

If your computer has the upper/lower case modification you may "lock" the 
keyboard into upper case mode with this command. (It corresponds to the 
SHIFT- LOCK key on a typewriter.) Pressing the key combination again will 
"unlock" it and upper case will then be entered by pressing the <SHIFT> key and 
the letter key* 

DICT-A-KATIC (CASSETTE ON/ OFF) <SHIFT^<ENTER > 

One of the most valuable functions of a word processer is being able to 
transcribe a recording such as the minutes of a meeting, letters, and other 
dictated texts. THE ELECTIC PENCIL has a built-in cassette stop- start command. 
By pressing <SHIFT>»<ENTER> the cassette recorder is turned on. When 
<SHIFT>-<ENTER> is pressed again, it is turned off. This permits you to control 
the dictation play back with the computer keyboard. 

Attach the cassette to the cassette port and plug the AUX and MIC plugs into the 
cassette recorder. Do not plug in the EAR plug (the black plug). Now, insert the 
tape cartridge into the player and depress the PLAY button. Set the volume 
control and press <SHIFT>-<ENTER> and the cassette player will begin operating. 
Press <SHIFT>-<ENTER> again and it will stop. 

The REWIND, FAST FORWARD and PLAY buttons, on the recorder, all function 
normally so you may fast forward and rewind without having to remove any plugs. 
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RESERVED FUNCTIONS 



The following control codes are not used by this release of THE ELECTRIC PENCIL 
but may be used by future releases or program modules that will provide added 
features for the THE ELECTRIC PENCIL. 



<CTL>-<A>, <CTLXW>, <CTL>-<S>, <CTL>~<Z>, <CTL>-<L>, 

<CTL>-<J>, <CTL>~<0>, <CTL>-<M>, <CTL>-<+> > <CTL>-< 3 > 1 

<CTL>-<.>, <CTL^</>, <CTL^<:>, <CTL^<->, <CTL>-<1>, 

<CTL^<2>, <CTL^<3>, <CTL^<4>, <CTL>-<5>> <CTL>-<6>, 

<CTL^<7>, <CTL>-<8>, <CTL>-<9>, <CTL>-<@>> <CTL>-<BRK>, 
<CTL>-<BRK>, <CTL>-<SFT> 
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SYSTEM MENU COMMANDS 



Within THE ELECTRIC PENCIL, is a SYSTEM MENU that permits you to enter 
additional commands that are related to THE ELECTRIC PENCIL/TR&-8G 
hardware/software system as a whole. 

To enter the SYSTEM MENU type <CTL>-<K> and the text display will be replaced 
with the SYSTEM MENU as shown in the figure below. 



THE ELECTRIC PENCIL SYSTEM MENU 



USED 


WORDS 





SAVE 


CASSETTE 


CSAVE 


SAVE SFLPPY 


@SAVE 


USED 


RECORD 





LOAD 


CASSETTE 


CLOAD 


LOAD SFLPPY 


@LOAD 


FREE 


MEMORY 


36600 


VRFY 


CASSETTE 


CLOAD? 


ERSE SFLPPY 


@NEW 


CURS 


SPEEDS 


CI- 10 


DISK 


DIRECTRY 


DIR 


CLER AFTCUR 


CAA 


TAPE 


SPEEDS 


LO-HI 


SAVE 


DSK FILE 


SAVE 


CLER BEFCUR 


CAB 


SAVE 


PRTDVR 


FSAVE 


LOAD 


DSK FILE 


LOAD 


CLER ALLTXT 


CLR 


LOAD 


PRTDVR 


PLOAD 


KILL 


DSK FILE 


KILL 


EXIT TO DOS 


EXIT 



TAPE = LO 



PRESS <BREAK> TO EXIT TO INPUT MODE 



CUR = 5. 



COMMAND? 3 
THE ELECTRIC PENCIL <C> 1981, MICHAEL SHRAYER 



While in the SYSTEM MENU, the standard keys are used without the CONTROL key. 

The SYSTEM MENU commands are NOT Control Character Commands. All commands must 

be terminated with <ENTER>. The LEFT-ARROW key (-*) is used to backspace and 
the <BREAK> key is used to exit the SYSTEM MENU. 

In the upper two-thirds of the SYSTEM MENU is a list of the command functions 
and their corresponding command statements. In the lower third is the command 
line itself and a solid non- flashing cursor. To enter a command, type the 
command and any additional parameters, such as file names or number values and 
press <ENTER>. If you eater an invalid command, an error message will be 
displayed and you may re- type the command. If the system detects an error, 
during an operation an error message will also be displayed. If you use the 
correct command but specify a parameter incorrectly the message; SYNTAX ERROR 
will be displayed. So much for what can go wrong - let's talk about what can go 
r ight I 

Because of the number of commands that need to be displayed, we have had to 
abbreviate the command functions. First we will review the menu format then the 
command functions and their abbreviations. Following that is a detailed 
discussion of each function and command. 
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SYSTEM MENU format; 



Abbreviated 
Command function 
(verify tape file) 



VRFY CASSETTE CLOAD? 



Command and /or current value setting 



Tbe SYSTEM MENU commands are divided into three groups: 

FUNCTION ABBREVIATION COMMAND PAGE 



UTILITY FUNCTIONS: 
Number of words in file , 
Number of records in file 
Amount of free memory » « 



USED WORDS 
USED RECORD 
FREE MEMORY 







36600 
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SPECIAL UTILITY COMMANDS (NOT DISPLAYED IN MENU): 

Save program configuration * . SETUP 49 

Do not save print values * * . PVOFF 49 

Save print values pvqn !!!!!!!!!! 50 



SYSTEM COMMANDS: 

Set cursor speed CURS SPEEDS 

Set tape speed (baud) ..... TAPE SPEEDS 

Save print driver SAVE PRTDVR 

Load print driver LOAD PRTDVR 

Clear all text after cursor . . CLER AFTCUR 
Clear all text before cursor . . CLER BEFCUR 
Clear all text from memory . . . CLER ALLTXT 
Return to DOS READY EXIT TO DOS 



CI- 10 
LO-HI 
PSAVE 
PLOAD 
CAA .. 
CAB .. 
CLR „ 
EXIT . 
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FILE COMMANDS: 
Save file to tape cassette . 
Load file from tape cassette 
Verify file on tape cassette 
Save file to Stringy Floppy 
Load file from Stringy Floppy 
Erase file from Stringy Floppy 
Display diskette's directory 
Save file on diskette . , w 
Load file from diskette * . 
Kill file on diskette . » * 



SAVE 
LOAD 
VRFY 
SAVE 
LOAD 
ERSE 
DISK 
SAVE 
LOAD 
KILL 



CASSETTE 

CASSETTE 

CASSETTE 

SFLPPY 

SFLPPY 

SFLPPY 

DIRECTRY 

DSK FILE 

DSK FILE 

DSK FILE 



CSAVE ( 
CLOAD , 
CLOAD? 
(3SAVE , 
@L0AD , 
@NEW *, 
DIR ,.« 
SAVE ., 
LOAD *. 
KILL #i 
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SYSTEM MENU UTILITY FUNCTIONS 



KUMBER OF WORDS IN TEXT FILE 

Each time you enter the SYSTEM MENU, THE ELECTRIC PENCIL calculates the number 

of WORDS you have entered into your text file from the cursor's present 

position in the file to the end of the file and displays it opposite "USED 

tfCRDS" 

A "WORD" is any character or group of characters with a space or <ENTER> (4-) 
character at either end. A "word" may be as short as one character and as long 
as one line. For instance, each of the following examples would count as one 
word: 

N« 

Now4 
Now * 

Nowisthetimef orallgoodmen^ 

Notice that there are three examples that begin with the word, "Now". In the 
first example the carriage return character immediately follows the "w" in 
"Now". In the next example there is a space between the "w 11 and the "<*" symbol 
but it is still counted as one word. In the next line there are a bunch of 
English words that have been run together. Of course you and I can read them but 
the computer cannot , so it counts the whole thing as one "word 11 . The string of 
equal signs (=) will also be counted as one "word". 



NUMBER OF RECORDS IN TEXT FILE 

Each time you enter the SYSTEM MENU, TEE ELECTRIC PENCIL calculates the number 
of RECORDS you have entered into your text file from the cursor's present 
position to the end of the file and displays it opposite "USED RECORD" 

A "RECORD" is any block of text that is terminated by <ENTER> ( *- ) or the 
FORM FEED ( | = MODEL I ♦ = MODEL III) character. A record may be as short as 
one character and as long as an entire text file 



FREE MEMORY 

The amount of memory you have left, in which you may enter your text file, is 

automatically displayed in the SYSTEM MENU opposite "FREE MEMORY". 

Each BYTE of memory may contain one character. Most text files average a word 
length of five characters per word. If you had 25000 bytes of memory remaining 
you would be able to enter approximately 5000 words in your text file* If you 
are writing a medical article and use words like, "phenumenultramicroscopic- 
volcanosilicosis" your text will not average five letters per word. Although 
your word count will be less, you etiil have the same amount of memory as 
someone who uses shorter words. 
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SYSTEM COMMANDS 



CONFIGURE THE ELECTRIC PENCIL SETUP (disk systems only) 

Each person likes to have his or her own special default print values, 
cassette baud rate and cursor speed. With the SETUP command, you can set-up THE 
ELECTRIC PENCIL'S print values, tape baud rate and cursor speed to suit your own 
personal tastes. 

To set your own default conditions, load THE ELECTRIC PENCIL and then set the 
CURSOR SPEED and TAPE BAUD rate from the SYSTEM MENU, Then, go to the PRINT MENU 
and set all of the values to suit your own needs. All of the values displayed in 
the PRINT MENU including the active print driver may be set. 

Now, return to the the SYSTEM MENU and type; 

COMMAND? SETUP :n <ENTER> 

where *n' is a drive number specification between and 3. A "set-up" file will 
be created on the specified drive. The name of this file will be, 
"PENCIL04/SYS". You may create or change this file at any time. You may also 
KILL it and the original ELECTRIC PENCIL default values will be used. If the 
drive specification is not used, the SETUP file will be saved to the first 
available diskette space. 

If you have created a custom print driver and have saved it with the PSAVE 
command and have it loaded at the TIME you issue the SETUP command, it will also 
be loaded and initialized when you type PENCIL<ENTER>, just as if it were part 
of THE ELECTRIC PENCIL program. (Also see PSAVE, PDRIVE, and USING A CUSTOM 
PRINT DRIVER.) 

NOTE: The SETUP command is not displayed in the SYSTEM MENU. 

TURN OFF THE "SAVE PRINT VALUES" FEATURE PVOFF 

To turn-off the save print values feature, from the SYSTEM MENU type: 

COMMAND? PVOFF <ENTER> 

Tape, Stringy Floppy and disk files made with previous versions of THE 
ELECTRIC PENCIL are compatible with this release. However, tape and Stringy 
Floppy files created with this release are NOT compatible with previous releases 
when the PRINT VALUES have been saved with the file. If you wish to create files 
that will be used on a previous release of THE ELECTRIC PENCIL, then turn off 
the SAVE PRINT VALUES feature with the PVOFF command. 

Also, when you are creating CHAIN files or JCL files for use under one of the 
various disk operating systems, such as NEWDOS/80 or LDOS, it is advisable to 
save those files with out the print values being saved with the file. 

NOTE: The PVOFF command is not displayed in the SYSTEM MENU. 
PVON (see below) is the default condition. 
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TURN ON THE "SAVE PRINT VALUES 1 ' FEATURE PVON 

To turn- on the save print values feature, from the SYSTEM MENU type, 

COMMAND? PVON <ENTER> 



NOTE: The PVON command is not displayed in the SYSTEM MENU, 
PVON is the default condition* 



SET CURSOR . S . PEE D "CI- 10" 

If the cursor seems to move too slowly, try this command using any number 
between n u and "10". Speed T, 0" is the slowest and speed "lJZf" is the fastest. 
With a little experimentation, you will determine the cursor speed that you are 
most comfortable with. 

The current cursor speed is displayed in the menu's status line as: CUR = 5. 
When you set the cursor speed this will be updated to reflect the current 

setting. 

With a lower cursor speed, the "debounce" capability of the keyboard routine 

is improved. Severe keyboard bounce can usually be cured with a speed setting of 

1 or 2 . 

SET CASSETTE BAUD RATE "LPHI" 

This command is valid only on the MODEL III machine. The MODEL I machine will 
ignore this command. Entering the rl LO" command will set the tape cassette speed 
to 500 baud. Entering the "HI" command will set the tape cassette speed to 1500 
baud. The "LO" command will permit the reading of tapes made on the MODEL I 
machine to be read on the MODEL III. Conversely, tapes made using the "LO" 
setting on the MODEL III may be read on the MODEL I. 

The default value, for the MODEL III machine is "HI" and of course the MODEL 
I machine will only display the "L0 f * setting ♦ 
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SAVE A PRINT DRIVER AS A "LOAD MODULE" "PSAVE f ilesoer. ;n" 

Once you have loaded and initialized a custom print driver, you may "SAVE" that 
driver as a "load module". (See "USING A SPECIAL PRINT DRIVER" Appendix II.) 
This means that when you use this driver in the future you will no longer have 
to set memory, load the DCB with the driver address, and initialize it All of 
these things will be done automatically. In fact, the print driver "load'module" 
can be used WITHOUT THE ELECTRIC PENCIL! module 

Suppose you have a special print driver for a Selectric typewriter that has 
been converted to a computer printer. For the sake of our example, let's say 
that you have named your print driver, "SELECDRV/CMD". Let's also suppose you 
have followed the instructions in "USING A SPECIAL PRINT DRIVER" in Appendix 
II. Now, your print driver is loaded, high memory has been set and the DCB 
initialized and you have THE ELECTRIC PENCIL running and want to make a "load 
module out of "SELECDRV/CMD" so that you don't have to go through all this 
rig-a-marole every time you want to use " SELECDRV/CMD" with PENCIL. For reasons 
known only to you, you want to save the load module to a diskette on drive one 

Go to the SYSTEM MENU by pressing <CTL>-<K>. Type the following: 

PSAVE SELECDRV/CMD :1<ENTER> 

This will save the print driver as a load module on drive one. If you wanted to 
save it to drive zero then you could use one of the two following methods; 

PSAVE SELECDRV/CMD :0<ENTER> 
PSAVE SELECDRV<ENTER> 

In the second example above, we did not specify the drive or the filename 
extension, "/CMD". THE ELECTRIC PENCIL will append the "/CMD" file name 
extension automatically. It will also save the "load module" to the first 
available diskette, drive zero in this case, if it has free space and is not 
write protected. 

A PSAVE using the same name as an existing print driver will cause the existing 
print driver to be overwritten. 

Also see Appendix II for more details on how to use a custom print driver. 
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LOAD A FRINT DRIVER "LOAD MODULE 11 "PLOAD filespec:n" 

This command will load a print driver created with the "PSAVE" command. (See 
"USING A SPECIAL PRINT DRIVER", Appendix II.) A print driver may be loaded at 
any time. Using the example above, let's "load" a print driver we have already 
created. The name of our "example print driver" is, "SELECDRV/CMD* 1 and we have 
it stored on a diskette in drive one. Go to the SYSTEM MENU with the <CTL>-<K> 
command and type any one of the below examples: 

PLOAD SELECDRV:KENTER> 
PLOAD SELECDRV/CMD:KENTER> 
PLOAD SELECDRV<ENTER> 
PLOAD SELECDRV/CMD<ENTER> 

All of the above examples will work. If there is another print driver on drive 
zero WITH THE SAME NAME, then the third and fourth examples will load from drive 
zero and not drive one since you did not specify the drive that the print driver 
will be loaded from. 

A PLOAD operation can only be performed when there is no text file in memory. 
This is because the PLOAD command will cause the available memory to be adjusted 
to a smaller value that may interfere with your text file. Any attempt to PLOAD 
a print driver with a text file in memory will result in the following message: 

PRINT DRIVER CANNOT BE LOADED WITH TEXT IN FILE SAVE b CLR FIRST 

To PLOAD a print driver when you have a text file in memory first, save the 
file. Second^ clear the file from memory with the CLR or CAA command. Third, 
PLOAD your print driver. Now, reload your original file. 
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CLEAR ALL TEXT AFTER CURSOR "CAA" 

T 'CAA" will clear all text in the file t from the current cursor position to the 
end of the file. When the text has been cleared, you will automatically exit 
from the SYSTEM MENU and may resume entering text. 

The clearing commands require three characters to be entered by the user as a 
precaution against accidental clearing of the file area and wiping-out your text 
file. These commands should be used with caution since any material in the file 
area cannot be retrieved once it has been erased from memory. Back-up copies of 
text should always be made of files before text is cleared. 

The PRINT VALUES are not affected by this command. 

CLEAR ALL TEXT BEFORE CURSOR "CAB" 

"CAB" will clear all text in the file, from the current cursor position to the 
beginning of the file. The character under the cursor will not be cleared. 
When the text has been cleared a you will automatically exit from the SYSTEM MENU 
and may resume entering text. 

The PRINT VALUES are not affected by this command. 

CLEAR ALL TEXT FROM THE SYSTEM "CLR" 

"CLR" will clear the entire text file area no matter where the cursor is 
positioned in the file. The video display will clear and you will return to the 
text input mode. 

The PRINT VALUES are not affected by this command. 

NOTE: "CLR", "CAA" and "CAB" should be used with care. 



EXIT THE ELECRIC PENCIL TO DOS "EXIT" 

To exit THE ELECTRIC PENCIL program to the "DOS READY" mode, enter the SYSTEM 
MENU and type: EXIT<ENTER>. When the command executes, the screen will clear 
and you will see the "DOS READY" message. It is possible on disk systems to 
re-enter THE ELECTRIC PENCIL by using the RESTART COMMAND (PENCIL *) unless you 
have executed another program that has overwritten the text buffer. 
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SYSTEM MENU FILE COMMANDS 



CAUTION 



SPECIAL NOTE ON ALL TAPE, STRINGY FLOPPY AND DISK 

OPERATIONS 



On previous releases of THE ELECTRIC PENCIL, the 
test buffer was cleared after a bad load, thereby 
eliminating any chance of recovering or partially 
recovering an important file that was recorded on 
media that had become damaged or had developed a 
parity error. With this release , any portion of a 
text file that loaded successfully, is left in the 
buffer with whatever errors it may have contained 
up to the point that it failed to load, INSPECT 
THE TEXT FILE BEFORE PROCEEDING! The clearing of 
the text buffer is YOUR option, not that of the 
program* 



NOTE: Also see SET TAPE SPEEDS above* 



LOADING MORE THAN ONE FILE A T A TIME 

You may concatenate (a fancy word meaning to join or link together) tape, 
Stringy Floppy and disk files in memory. Simply load each file until you have 
loaded all of the files needed for your final document. If an entire file will 
not fit into memory you will receive the message: 

FILE AREA FULL 



CAUTION: Partially loaded files ARE NOT CLEARED FROM MEMORY I Inspect your file 
ae you may wish to clear the partially loaded file with the CAA command* 

Using this feature is an excellent way to build form letters, contracts, legal 
forms, technical manuals or any other document that requires the use of 
"standard" paragraphs or sections that you have saved as separate text file*. 
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LOAD A TEXT FILE FROM TAPE "CLOAD" 

Entering the "CLOAD" command causes the cassette tape deck to be activated 
and a text file that is stored on tape, to be loaded into memory. 

To LOAD a text file that is on cassette tape into the file area of THE 
ELECTRIC PENCIL, first position the tape to a few inches before the start of the 
file, then enter the tape read command CLOAD and press <ENTER>. (Don't forget to 
set the volume control before starting the load.) The cursor will disappear from 
the screen. The computer is waiting for input from the tape. Now press the 
cassette recorder's "PLAY" button and the program will begin reading your text 
rile into memory. 

When the file has been correctly read into memory, "TAPE FILE LOADED" will 
appear on the screen, if there has been an error in the reading of the tape 
the message "TAPE ERROR" will appear. P * 

When a file is read into THE ELECTRIC PENCIL, it is placed at the end of any 
text file that may already exist in the file area. If this is to be a new file, 
the file area should be cleared (See "CLR", "CAA" and "CAB"). If the incoming 
file is too long for the existing memory, "FILE AREA FULL" will appear on the 
screen. 



CAUTION: Partially loaded files ARE NOT CLEARED FROM MEMORY! Inspect your file 
as you may wish to clear the partially loaded file with the CAA command. 

EXAMPLE: 
CLOAD<ENTER> - Read tape file into memory at the current baud rate. 

Pressing the <BREAK> key during a CLOAD operation will terminate the load. That 
part of the file, which has been successfully loaded will remain in memory. 
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WRITE A TEXT FILE TO TAPE "CSAVE" 

Entering the "CSAVE" command causes the cassette tape deck to be activated and 
a text file that is in memory to be recorded (stored) on cassette tape. 

To write a file onto cassette tape, first place the cursor to the position in 
the file FROM which you wish to write. If the entire file is needed, then 
<CTL>-<B> should be used to place the cursor at the beginning of file. <CTL^<K> 
will then bring up the SYSTEM MENU* 

Place the cassette recorder in RECORD MODE at a convenient location on the 
tape. Enter the "CSAVE" command and press <ENTER>. The cursor will disappear and 
writing will begin. When the file has been recorded onto the tape, "WRITTEN 11 
will appear on the screen. 
EXAMPLE; 

CSAVE<EKTER> - Write tape file onto cassette tape at the 
current baud rate. 



NOTE 



After you have written your text file to the tape, 
it is recommended that you VERIFY the tape before 
proceeding further. See VERIFY below. 



When working with a long text, it is advisable to periodically write the file 
onto tape as a precaution against power failures which can destroy all material 
m the file area as well as THE ELECTRIC PENCIL program as it is stored in 
memory. 



Pressing the <BREAK> key during a CSAVE operation will terminate the save. 

A file partially saved to tape may be reloaded into the file area with the 
CLOAD command. However, THE ELECTRIC PENCIL will report a TAPE ERROR when it 
encounters the end of the file since it was not fully saved. 

That part of the file which has been successfully loaded will remain in 
memory. 



57 



THE ELECTRIC PENCIL Version 2. Oz 



VERIFY TAPE WRITE "CLQAD? 11 

"CLOAD?" is basically the same as "CLOAD" except the file is not placed 
into the file area* It is, however, checked for correctness. When a tape file 
has been verified, the message, "TAPE FILE VERIFIED" will be displayed if the 
tape is correct or with "TAPE ERROR" if it is not. A tape just written showing 
"TAPE ERROR" should be re- written with the "CLOAD" command. Continual tape 
errors indicate faulty tape or a faulty cassette recorder. 

After writing a file to the tape, be sure to rewind it before executing the 
CL0AD7 command and then set up the cassette tape recorder as if you were going 
to LOAD a file. 
EXAMPLE: 

CLOAD?<EMTER> - Verify tape file with memory file. 



Pressing the <BREAK> key during a CLOAD? operation will terminate the CLOAD? 
(verify) operation. 
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STRINGY FLOPPY FILE COMMANDS 



NOTE: On all Stringy Floppy file operations: 

Pressing the <EREAK> key during ANY Stringy Floppy file operation will abort the 

operation and ttie message, "BREAK" will be displayed. 

On disk systems, an Electric Pencil system overlay will be loaded from disk 
each time you ISSUE a Stringy Floppy file command. 

All Stringy Floppy error messages are generated by the Stringy Floppy's own 
software. Consult your Exatron Stringy Floppy operating manual for the meaning 
of these error messages. 

SAVE TEXT TO STRINGY FLOPPY WAFER ffSAVEn:n 

@SAVE1:1 will cause the text in memory from the current cursor position to the 
end of file to be written to the EXATRON STRINGY FLOPPY wafer on drive number 
one as file number one. The format of the SAVE command is as follows: 

File number on EXATRON STRINGY FLO PPY wafer. Hay be 



any number from 1 to 99. The default value is one. 



@SAVE1 : 1 

i t 



STRINGY F LOPPY I I Drive specification Number. May be 
SAVE command. any number between and 7» The de- 

fault value is 0. The ":" separator 
is mandatory when specifying a drive 
number. 

The file specification and drive specification are optional* If they are not 
specif ied> then the default values are used. The file number default is Vl" and 
the drive default is "0". 

The SAVE command automatically performs an @NEW function on the entire wafer 
AFTER file #1! This prevents the writing of a file that is longer than the 
available space on the EXATRON STRINGY FLOPPY wafer, 

CAUTION: Because of the way in which the Stringy Floppy handles its SAVEs it is 
NOT recommended practice to put multiple files on Stringy Floppy wafers 

If there is not room on the current wafer to write the text file you will get 
the message: 

TAPE TOO SHORT ERROR 

CAUTION; Because the files are ERASED before they are SAVED, make sure you have 
a spare wafer ready in the event that you have a valuable text file that must be 
saved to the EXATRON STRINGY FLOPPY wafer. 

Important files should be on their own Stringy Floppy wafer* In this way you 
will always be sure to have room for the file. 
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READ STRINGY FLOPPY WAFFER ELOANii:n 

t d LOADl:l will cause the EXATRON STRINGY FLOPPY, drive number one, to load text 
file number one on the wafer that ie currently in drive one. The format of the 
LOAD command is as follows: 

File number on EXATRQN STRINGY FLO PPY wafer. May be 
I any number from 1 to 99, The default value is one, 

@LOADl:l 

STRINGY FL OPPY T I Drive specification Number. Mav be 

LOAD command, any number between and 7. The de- 

fault value is 0, The ,T :" separator 
is mandatory when specifying a drive 
number. 

The file specification and drive specification are optional. If they are not 
specified, then the default values are used. The file number default is "1" and 
the drive default is "f} Tl . 
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ERASE STRI NGY FLOPPY WAFFER flHKy n:n 

@NEW1:1 will cause file number one, in the EXATRON STRINGY FLOPPY drive number 
one, to be erased. gNEWil will cause ALL files to be erased on the EXATRON 
STRINGY FLOPPY wafer in drive one I The format of the NEW command is as follows: 



STRINRY H^PPV 
NEW command . 



@NEWi : 1 

J t 



File number on EXATRQN STRIKGY FLOP PY wafer. Hay be 
any number from 1 to 99* The default value is one. 



Drive specification Number. Mav be 
any number between and 7. The de- 



fault value is 0f. The 



n * ii 



separator 



is mandatory when specifying a drive 
number 

The file specification and drive specification are optional. If they are 
specified, then the default values are used. The file number default is "1" 
the drive default is "0". 



not 
and 



CAUTION: 



Use this command carefully as you may unintentionally erase all files. 
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DISK COMMANDS 



SPECIAL NOTE ON DISK FILE OPERATIONS 



All the disk files are LOADed and SAVEd with the 
file extension "/PCL". This is how THE ELECTRIC 
PENCIL is able to recognize files that it has made 
as its own. It also has the advantage of filtering 
out files which are NOT ELECTRIC PENCIL files when 
you ask for a DIRectory listing from THE ELECTRIC 
PENCIL'S SYSTEM MENU. You may also LOAD and SAVE 
files that have any other file extension. See DIR, 
LOAD, SAVE and KILL below* 



All the TRS-DOS rules apply to drive, file 
specifications 3 and passwords. Consult your DOS 
manual for particulars concerning disk operations, 
file specifications and disk drive numbering spec- 
ifications. 
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DISPLAY DISK DIRECTORY DIR ;n 

The "DIR" command will obtain a DIRECTORY of The ELECTRIC PENCIL files with 
the file extension lf /PCL" only, on any disk drive* Enter the SYSTEM MENU with 
the <CTL>-<K> command. Now type "DIR" and press <ENTER>. The screen will clear 
and any ELECTIC PENCIL files that exist on DRIVE will be displayed . If there 
are no PENCIL files , then the screen will remain blank. 

By placing a number after "DIR", like this: "DIR1", we will get a listing of 
the PENCIL files on DRIVE ONE, 

*n' may be any number between j5 and 3. If no number is appended to the "DIR" 
command, the default drive will be drive zero. 
EXAMPLE; 



DIRtf<ENTER> 
DIR<ENTER> 
DIRKENTER> 
DIR2 <ENTER> 
DIR3<ENTER> 
DIR :3<ENTER> 



Display directory of Pencil files on drive zero. 

Display directory of Pencil files on drive zero. 

Display directory of Pencil files on drive one. 

Display directory of Pencil files on drive two. 

Display directory of Pencil files on drive three. 

Display directory of Pencil files on drive three, 
the space and colon are optional 
on the "DIR" command. 



To obtain a directory listing of ALL files, regardless of the file extension, 

precede the drive specification with an asterisk. 

EXAMPLE: 



DIR*0<ENTER> 
DIR*<ENTER> 
DIR*KENTER> 
DIR*2 <ENTER> 
DIR*3<ENTER> 
DIR :*3<ENTER> 



- Display directory of ALL files on drive zero. 

- Display directory of ALL files on drive zero. 

- Display directory of ALL files on drive one. 

- Display directory of ALL files on drive two. 

- Display directory of ALL files on drive three, 

- Display directory of ALL files on drive three, 
the space and colon are optional 

on the "DIR" command. 



63 



THE ELECTRIC PENCIL Version 2 .Oz 



SAVE TEXT to DISK FILK SAVE f i lesoec/gxf :n 

SAVE is the reverse function of LOAD (see below). SAVE will cause the text 
tile to be written to a disk file FROM the current cursor position in the file 
to the end of the file. If a file name extension is not specified, then the 
extension "/PCL" vill be added to the filename. The same file specifications 
apply to SAVE as apply to LOAD. 
EXAKPLE: 

SAVE EXAMPLE<ENTER> - Saves a file on the first 

available drive with the 
file name: "EXAMPLE/PCL"* 
SAVE EXAMPLE :2<£NTER> - Saves a file on drive two 

with the file name: "EXAMPLE/PCL". 
SAVE EXAKPLE.MIKE:2<ENTER> - Saves a file on drive two with 

the file name: " EXAMPLE/PCL" and 
the password: "MIKE" 
SAVE EXAMPLE/ :2<ENTER> - Saves a file on drive two 

with the file name: "EXAMPLE". 
SAVE EXAMPLE/TXT :2<ENTER> - Saves a file on drive two 

with the file name: "EXAMPLE/TXT". 

NOTE: The colon (:) is mandatory when entering a drive specification. 

If you want to SAVE a file with an extension other than "/PCL" then the file 
must be saved and loaded with your file name extension. To SAVE a file without 
an extension, enter the slash (/) at the end of the file name without an 
extension. Also see "DIR *» above to display file names with extensions other 
than "/PCL . 

It is possible to "lose" a disk file with the SAVE command. You don't actually 
lose the file, but cause it to be overwritten with the last few bytes at the end 
of the file m the text buffer. It is not the program's or the machine's fault 
it is yours and here is how it happens. (The following is excerpted from* 
TRS-80 Disk & other Mysteries" by H.C. Pennington. - reprinted by permission) 

There are two reasons for this unfortunate circumstance: 

UNFORTUNATE REASON #1: You were working on this file only a couple of days ago. 
Everything was working smoothly and when you were through entering your text* 
you saved the file to the disk. You removed the disks from the drives, shut 
everything down and went home (or to another room) and watched an exciting* rerun 
of "I Love Lucy" before dinner. 

Several days (or hours) later you went back to the computer to use that file. 
You bring up THE ELECTRIC PENCIL program and load the file. What??! I! It's GONE I 
There are only three carriage returns on the screen I After the blood returns to 
your brain and you finally begin to believe your eyes, reason returns to your 
fogged brain; you decide you must have saved it on another disk. 

Forty- seven disks later you give up and say to yourself, "...damnit, I KNOW I 
saved that file. I wonder what could have happened to it? It must have been 
eaten-up by the machine or something." Thus, you conclude that there are 
mysteries that are beyond human understanding and consult the TV Guide to see 
what time Mork & Mindy come on. 
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The truth of the matter is that nobody ate nothin'. Everything worked exactly 
Like it was supposed to, you screwed up. In your dazed and confused state, after 
typing for six hours, you T 'SAVE"d your file WITH THE CURSOR AT THE END INSTEAD 
OF AT THE BEGINNING OF THE FILE! 

UNFORTUNATE REASON #2: You accidentally "KILL"ed the file by using the wrong 
file name. I don't know why you did it but it sometimes does happen. (By 
permission from the author.) 



There is not room here to quote the recovery techniques, but you may obtain 
a copy of "TR&-80 Disk & Other Mysteries" and learn them with very little 
effort. 

There is one other common problem with the SAVE command. When the cursor is 
at the absolute end of the file and there are no characters of any kind, 
including carriage returns, if you attempt to SAVE the file, you will get the 
message: 

NO FILE 

It simply means that there is no text file BEYOND THE CURRENT CURSOR POSITION. 
Return to the text buffer and with the <BREAK> function, shift the cursor to the 
beginning of the text and then SAVE the file. 

A SAVE when the cursor is not positioned at the very beginning of the file, 
will cause this message to be printed in the "copyright" line of the SYSTEM 
MENU: 

WARNING: CURSOR NOT AT BEGINNING OF FILE ONLY PART OF FILE SAVED 

Hopefully, this message will help you to avoid the circumstances that caused 
UNFORTUNATE REASON #1 , above. 
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LOAD TEXT FROM DISK LOAD f ilesoec/ext :n 

To LOAD a text fiLe from a diskette you must eater the LOAD command and the 
file specification. The drive number is optional. If a file name extension is not 
specified, then the extension "/PCL" will be added to the filename. 

For instance, suppose we have a three drive system and two identical files on 
drives one and two. Our "system" disk is in drive zero. The name of our example 
file will be "EXAMPLE/PCL". Of course we will only see the file name "EXAMPLE" 
when we do a directory from PENCIL'S SYSTEM MENU unless we use DIR's asterisk 
option (see above). 

Bow the reason we have saved the same identical file on two separate 
diskettes is because we have made some changes to one of the files but not the 
other. Because we stayed up too late last night, watching the late- late- late 
movie on channel five, we saved the text to another diskette and forgot to give 
it a different name. Now, we have to load the file, but which one? 

There are two things we can do. We could put one of the diskettes in drive 
one ^and load the file. If it was the wrong one, clear the text buffer with the 
CAA" command, remove the first disk and insert the second one, then repeat the 
process. 

The second thing we could do is put the first diskette in drive one and the 
second diskette in drive two. Now we will load the file from the diskette on 
drive one like this: 

LOAD EXAMPLE : 1<ENTER> or like this: 
LOAD EXAMPLE<ENTER> 

NOTE: The colon ( : ) is MANDATORY when specifying the drive specification. 

Remember that the DOS will load the file from the first diskette that it finds 
that file name on - if we use the second of the two above examples. Since the 
first place that it will find it is drive one, we don't REALLY need to specify 
that drive. 

Now we will inspect the file that we have loaded. DAMN! It's the wrong one. 
Well, Murphy wins again. Now we will clear the buffer with the "CAA" or "CLR" 
command, and load the file from the diskette on drive two like this: 

LOAD EXAMPLE :2 <ENTER> 

The system will ONLY look on drive two. If it does not find the file there it 
will not look on any other drive. In this case we have inserted a diskette on 
drive two with the "EXAMPLE/PCL" file on it, so it will find it and load it. 

If you have a file in the text buffer and load a file from the disk and do not 
clear the text buffer, the file will load at the END of the text file in memory. 
This is especially useful when writing "form" letters where you have various 
standard" openings, paragraphs and closings. 

If you want to LOAD a file with an extension other than "/PCL" then the file 
must be saved and loaded with your file name extension. Also see "DIR *" above 
to display file names with extensions other than "/PCL". 
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KILL DISK FILE 



KILL filespecin 



This command will delete a file from the disk. It will not cause anything to 
be altered in the memory. It will simply find the file, if it exists on the 
disk, and remove it from the directory. 

If a file name extension is not specified, then the extension "/PCL" will be 
added to the filename. 
EXAMPLE: 



KILL EXAMPLE<EHTER> 



KILL EXAMPLE :2<ENTER> - 



Deletes the file named 

M EXAMPLE/PCL M on the the first 

diskette on which the file 

is found. 

Deletes the file named 

"EXAMPLE/PCL" on the diskette in 

disk drive two. 



NOTE; The colon (;) is mandatory when specifying the drive specification. 
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PRINT MENU COMMANDS AND THE SETTING OF PRINT VALUES 



PRINTING A TEXT FILE 

Entry to the PRINT MENU is accomplished by pressing the <CTL>-<P> keys, 

screen will be cleared of all text and the PRINT MENU will be displayed. 



The 



Current value 



Abbreviated command function 



Comman d and value ranfi e 



cJe. 



TflE ELECTRIC PENCIL PRINT MENU 

RGHT JUSTFY RJ0-1 

LEFT MARGIN LM0-255. 1 
65 LINE LENGTH LL1-2 55. 

1 LINE SPACNG LS1-255 300 
58 PAGE LENGTH PL1-255, 

1 PAGE SPACNG PSO-255- M 

1 PRNT RECRDS PRO-2 55. 8 

PAGE NUMGER PN1-65536 1 



HALT FMFEED 
LFED OFF/ ON 
CRTN OFF/ ON 
BAUD SETTNG 
NULL NUMBER 
UART PARITY 
UART WORDLN 
STOP BITS 



HF0-1 

LF0-1 

CR0-1 

BSnnnn 

NN0-2 55 

UPE-OM 

UW7-8 

SB1-2 



ACTIVE PRINT DRIVER: PA PARALLEL=PA TRS232=TR UART-UA 




PRESS <ENTER> TO PRINT / PRESS <BREAK> TO EXIT 



COMMAND ? 



print driver status line 



command input line 



NOTE: You may change the print value and printer control value settings to your 
preference at any time. See "SETUP" above. Print values and printer control 
values may or may not be saved with the text file. See "PVOFF and "PVON" above. 
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The print value commands and printer control commands 
groups : 



are divided into three 



FUNCTION 



ABBREVIATION 



PAGE 



PRINT VALUES 

Justify right margin RGHT JUSTFY 

Set left margin LEFT MARGIE 

Set line length LIKE LENGTH 

Set line spacing LIKE SPACNG 

Set number of lines per page PAGE LENGTH 

Set number of lines between pages . . . PAGE SPACNG 

Set starting page number PAGE NUMBER 

Set number of records to print . . . • PRNT RECRDS 



. 69 

• 70 
. 71 
. 72 
. 73 
. 74 

• 75 
. 76 



PRINTER CONTROL COMMANDS 
Set printer to halt on form feed . . . HALT 
Line feed with carriage return off /on . CRTN 
Carriage return with line feed off /on . LFED 

Set RS232c baud rate (UART) BAUD 

Set number of nulls on serial output . NULL 

Set parity on serial output UART 

Set number of stop bits (UART) , . . , STOP 
Set serial word length UART 

PRINTER PORT CONTROL 

Select parallel printer port PA 

Select TRS232 serial/cassette port , . TR < 
Select RS232c (UART) serial port . . . UA < 



FMFEED . . 


. . 77 


OFF/ON . , 


, . 78 


OFF/ON . , 


, . 79 


SETTNG . , 


, . 80 


NUMBER . , 


. . 81 


PARITY . , 


, . 81 


BITS . . , 


. . 81 


WORDLK . , 


. . 81 



82 
82 
82 



The PRINT FORMATTING commands and their VALUES are typed and the <ENTER> key is 
pressed. The values will be immediately set and displayed. This "menu" displays 
the value of the current PRINT VALUE settings, the PRINT VALUE mnemonics and the 
print driver that is currently active. Pressing the <ENTER> key will cause the 
text file to be printed on the line printer . .Pressing the <BREAK> key vill 
return you to the TEXT ENTRY mode . 

When a file is saved to tape, Stringy Floppy or diskette, the file print 
values are saved at the end of the file. When the file is loaded, the print 
values will be set according to the setting when the file was saved* Files saved 
under previous versions of THE ELECTRIC PEHCIL will not cause the print values 
to be changed (i.e., "old" files are compatible with the "new" PENCIL). 

To start printing your file from the current cursor position in the text to 
the end of the file, simply press the <ENTER> key and printing will begin 
immediately. 
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ud T Drior r ?f ° f ? e P ^ nted P3ge " determined b y the PRINT VALUES you have set 

Xi.'sn t: 5.^2; jSpS;^- suppose we had a bi ° ck ° f — *•* ^.d 




the Wi eLin^ Uke the ! Xample bel ° W Wh6n WG hEVe f0 ^tted it as described in 
<ENTER>^ P" a S"Ph above and then cause it to be printed by pressing the 
<ENTER> key while in the PRINT MENU mode. 



This is an example of formatting the 
text. We will take this example, which 
looks one way on the video and print it 
so that it looks entirely differently on 
the paper. We will enter the PRINT MENU 
by pressing the CONTROL and the "P" keys 
at the same time. Then we will set the 
line length to forty characters wide by 
entering the command, LL40; set the 
left margin at ten spaces with "LM10" 
and we'll cause it to be right justified 
by entering "RJ1". 



THE ELECT RIC PENCIL PRINT DRIVKRS 

Three hardware printer interfaces are supported; the standard n^lloi 

bortware TRS232 serial printer interface (cassette port) THE ELFrTRTr pttwptt 
TEEM position on the MODEL I. This s„itch doe. not exist on the MODEL III. 
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PRINTING MULTIPLE COPIES 

You may print your file up to 255 times (ideal for form letters) by entering 
a number prior to pressing the <ENTER> key while in the PRINT MENU. Here is an 
example that would cause the file to be printed twenty-five times: 

COMMAND? 2 5 <ENTER> 

Entering a 1 will have the effect of pressing <ENTER> without a number; the file 
will be printed one time. 

SPECIAL NOTE ON MULTIPLE COPIES: 

When printing multiple copies , and you want to have the first page of each copy 
start at the top of a page, BE SURE TO PUT A FORM FEED AT THE END OF YOUR FILE. 
This will cause the printer to skip to the beginning of a new page when the last 
page of the text file has been printed. Failure to put a FORM FEED at the end of 
the file, will cause the start of the next copy to begin printing one line below 
the end of the first copy instead of at the top of the next page. 

PRINTER COMPATIBILITY 

Some serial printers require fill characters (nulls) after each carriage return 
to allow time for the carriage to reach the home position. If, for example* 
your printer requires 5. fill or null characters (see your printer manual), you 
may set the number of nulls to be sent to the line printer after each carriage 
return by entering the command "NNn" where the *n' may be any number between 
and 2 55. Also see SET NUMBER OF NULLS, below. 

Set up your printer by manually advancing the paper to the location where you 
want printing to actually start. Then place the cursor over the first character 
of the text that you want to print and type; 

<CTL^<P> 

The PRINT MENU will be displayed. If all of the print values are set to your 
satisfaction, press the <ENTER> key and printing will start immediately, 
assuming that your printer is on and properly set up for printing. 

Some printers will seem to ignore ir blank lines". These are lines that you 
have specified as "blank" by putting a carriage return (<-) at the extreme left 
of the display. The Centronics model 77 9 is one of these printers. To correct 
this, you will have to precede a carriage return at the extreme left edge of the 
display, with a space. 

Other printer control commands are the "line feed on/off" (LFn) and "carriage 
return on/off" (CRn) commands. Consult the manual for your printer to determine 
whether or not you may use these commands. 



RECOVERING FROM A "HUNG PRINTER" CONDITION. 

From time to time you may want to print something but for some reason or 
another, have failed to connect or turn on the printer. Most programs will 
hang-up until the printer is properly attached. THE ELECTRIC PENCIL will let 
you recover from this condition by pressing <BREAK>^<CLR>. Sometimes pressing 
the <EREAK> key by itself will regain control. 

Tfeds abort feature works ONLY on the BUILT IN PRINT DRIVERS. 
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PRINT VALUES 



JUSTIFY RIGHT MARGIN 



"RJ0-RJ1" 



To set the JUSTIFY parameter, enter the command, "RJ1" # To turn off the 
JUSTIFY parameter, enter the command, "Rjtf". Justification of text will cause 
each line to be printed to the maximum setting of the line length, with the last 
non-space character in the extreme right position on each line. The default 
value is 0. 



With the justification off 
margin "ragged 11 like this; 



("RJ#"), file will be printed with the right hand 



A computer without an operating system is of little use* The 
reason we need an operating system is to provide a means of 
communication between the computer and the user. This means 
getting it to "listen" to the keyboard so that it will know 
what we want, and having it tell us what's going on by putting 



Setting the justification parameter to "RJl" will cause to file 
with the right margin justified as follows: 



to 



printed 



A computer without an operating system is of little use. The 
reason we need an operating system is to provide a means of 
communication between the computer and the user. This means 
getting it to "listen" to the keyboard so that it will know 
what we want, and having it tell us what's going on by putting 
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LEFT MARGIN 



"LM0 - LMZ55" 



This sets the left margin. If your printer is an eighty column printer, you 
must be careful when setting your margins too far to the right. This will cause 
the printer to do one of two things depending on the line width you have set: 

1. When the printer reaches the far right margin, 

it will stay at the right margin and print in one 
place. 

2 . When the printer reaches the far right margin, 
it will issue a line feed and carriage return of 
its own. The line will continue to print on the 
next line until THE ELECTRIC PENCIL issues a 
carriage return. The text will have extra lines and 
lines that are incomplete. 

The default value is 0. 

With the left MARGIN setting at zero your file will print as follows: 



A computer without an operating system is of little use. The 
reason we need an operating system is to provide a means of 
communication between the computer and the user. This means 
getting it to "listen" to the keyboard so that it will know 
what we want, and having it tell us what's going on by putting 



With the left margin setting at 10 (LMIJT), your file will print as follows: 



* 



A computer without an operating system is of little use. The 
reason we need an operating system is to provide a means of 
communication between the computer and the user. This means 
getting it to "listen" to the keyboard so that it will know 
what we want, and having it tell us what's going on by putting 



In the above example, justification is set to RJl (on). 
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LINE LENGTH 



"LL1" to "LI2 55" 



This sets the number of characters that will be in each printed line. When 
the RIGHT JUSTIFICATION is off, each line will be printed with the right margin 
ragged and words will not be broken in the middle of a word. When JUSTIFICATION 
is set, each line will be spaced out so that the last letter of the last word of 
each line ends at the maximum line length you have set. If JUSTIFICATION is NOT 
set, then instead of spacing out the line so that the right margin is even, it 
will fit as many words as possible on each line without adding any extra spaces 
between words. 



For example, with the line length value set to 50 (LL50), a file that looks 
like this on the video display... 




Will be printed like this... 



A computer without an operating system is of 
little use. The reason we need an operating system 
is to provide a means of communication between the 
computer and the user. This means getting it to 
"listen" to the keyboard so that it will know what 
we want, and having it tell us what's going on by 
putting 



50 Characters 



In the above example, right justification (RJ1) is not on 
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LINE SPACING 



'LSI" to "LS2 55" 



This parameter sets the spacing between lines. "LSI" will cause each printed 
line to be spaced normally. "LSI" will cause each printed line to be double 
spaced, and "LS5! 1 will have five spaces between lines. The default value is 1. 



With line spacing set to two ("LS2"), a file that looks like this... 




.•♦will be printed like this: 



A computer without an operating system is of little use. The 
reason we need an operating system is to provide a means of 
communication between the computer and the user. This means 
getting it to "listen" to the keyboard so that it will know 

having it tell us what's going on by putting 



THE ELECTRIC PENCIL will count blank lines in its PAGE LENGTH count. If you had 
set the page length at sixty (PL60; see below), there would be thirty text lines 
and thirty blank lines. 
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PAGE LENGTH 



"PL0" to "PT2SV' 



This print formatting command sets the number of lines that will be printed on 
each page. A setting of "PL60" will print sixty lines per page. The default 
value is 58. 

On paper that is continuous, this setting is important because it interacts 
with the PAGE SPACE command (See below) to set the number of lines that will be 
printed on a single page and the number of lines between pages, 

A single 8 1/2" by 11" sheet (either continuous form or single sheet paper) 
has space for 66 lines, when printed solid from top to bottom with the line 
printer set at 6 lines per inch* 

PAr^cPAPrJ 1 ^^ u el ° W » the relations fciP between the paper size PAGE LENGTH and 
fAOL bPACING will become apparent. This example is with 8 1/2" by 11" con- 
tinuous form paper. The line printer is set to 6 lines per inch and the 
character spacing set to 10 characters per inch or PICA size letters. 



Left Margin 8 (LM8) 
(Approx. 3/4") 



8 Lines 
(PS8) 

Line Length 70 
characters (LL70) 




PAGE 1 



> PAGE 2 



> PAGE 3 
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PAGE SPACING "PSfl" to "PS2 55 " 

This sets the number of lines between pages. On printer paper that is 
continuous, this setting is important. If it is set incorrectly then each page, 
after the first page will start higher or lower on each succeeding page The 
default value is 8. 

For proper page spacing, the values for "PL" (Page Length) and "PS" (Page 
Spacing) must total the number of lines per page. For instance, with the 
printer set for six lines per inch, a standard 8 1/2 by 11 inch sheet of paper 
has 66 lines. With the printer set at eight lines per inch, a standard sheet has 
an lines. In the first case, the values for "PL" and "PS" must total 66 and in 
the second they must total 88. Also see figure above. 

PAGE NUMBER "PNfl" to "PN65536" 

To set the page number enter the number you want your pages to start at 
type the number next to the "PN". Suppose, for example, you want your page 
numbering to start at "10". Type: PN10<ENTER>. When you start printing your 
file, start printing with the cursor over the dollar sign (S) and the pages will 
be numbered automatically starting at "10". The default value is 1. Also see 
TITLING NUMBERING AND UNDERLINING below. 

PRINT LENGTH (RECORDS) "PRfl" to "PRISV' 

This parameter "counts" the number of carriage returns that follow a group of 

words or characters that have been printed. It assumes that each carriage 

return following a group of words or characters represents a "record" or 

paragraph". When "P" is set to zero, the number of records that will be printed 

is unlimited. F 

The default value is 0. 
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PRINTER CONTROL COMMANDS 

These commands CONTROL the printer's actions but do not affect the PRINT VALUES 
as discussed above. 



HALT PRINTER ON FORM FEED OFF/ON "HFfl" - "HFl" 

If you can use single sheets in your printer, this command will cause the 
printing action to stop each time THE ELECTRIC PENCIL issues a FORM FEED or 
spaces between pages* This will allow you to insert a new sheet of paper, 
position it 4 and then by pressing any key on the keyboard, the printer will 
continue until it reaches the end of the file or the next FORM FEED, 

The default value is (off), 

CARRIAGE RETURN OFF/QN "CRfl" - "CRl" 

This command controls the sending of a carriage return to the line printer 
when the end of a line is reached* This command is required by most Centronics 
printers to be on, 

CR0 = Carriage return OFF, 
CR1 = Carriage return ON. 

The default value is 1 (on), 

LINE FEED OFF/ON "LFg" - "LF1" 

This command controls the sending of a line feed to the line printer when the 
end of a line is reached. This command is required by most Centronics printers 
to be off. 

If you are getting extra spaces between lines, or have a requirement for 
underlining, IT LF" should be set "LFO". 

LF0 = Line feed OFF, 
LF1 = Line feed ON. 

The default value is (off). 

NOTE: LOCAL LINE FEED, on your printer, must be off in order to underline. See 
UNDERLINING below. 
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SERIAL BAUD RATE SETTING "BSnnnn" (UART and TRS232 ) 

This command will set the baud rate for the Small Systems Software print 
driver and the UART (TRS-80's RS232c serial interface), 'nnnn' can be any valid 
baud rate setting as listed below. Baud may be reset at any time. The default 
value is 300 baud, 

110* 134.5* 150 300 600 1200 2400 4800 9600 

Entering a baud rate not in the above list will cause the error message, "SYNTAX 
ERROR" to be displayed. 

* NOTE; The selection of 110 or 134,5 baud will automatically set the number of 
stop bits to 2* If you require a different number of stop bits set when baud is 
set at 110 or 134,5 you will have to RESET the stop bits AFTER setting the baud 
rate at 110 or 134.5. The selection of any other baud rate automatically sets 
the number of stop bits to I which may also be reset if you desire two stop 
bits. 



SET NUMBE R OF HULLS "NN0" to T, KN2 55" (UART and TRS232) 

Some serial printers require that "fill 11 or "null" characters be sent after 
each carriage return to allow enough time for the carriage to reach its home 
position. If your printer requires five null characters, for example, set the 
null output by entering "NN5" from the PRINT MENU, The number of nulls may be 
reset at any time. The default value is 0. 

SET UART (RS232c) PARITY "UPE" - "UPQ" - "UPM" (UART) 

"OPE" sets parity EVEN. "UPO" sets parity ODD (NOTE; IT 0" is the letter "G", 
not the number zero.)* "UPM" sets parity to MARK or NO PARITY. Default VALUE is 
set to M. 



SET STOP EITS "SB1" to "SB2 " (UART and TRS232) 

Sets the number of stop bits at one or two. The default value is 2. Stop 
bits are automatically set to "2" when the baud rate is set to 110 or 134.5 but 
may be reset to "1". 

SET WORD LENGTH "UW7" - "UW8" (UART) 

Sets the word length to seven or eight bits* The default value is 8* 

Whether or not you will use these commands will depend upon your printer. Refer 
to your printer's documentation to determine the requirements necessary for its 
operation. We have set the default values to those most commonly used. 



79 



THE ELECTRIC PENCIL Version 2 ,0b 



PRINTER PORT SELECTION 



PARALLEL PRIMTER ACTIVE "PA" 

If you have activated another print driver (see below), you may re- activate 
the parallel printer driver by entering "PA" from the PRINT MENU. When the 
Parallel print driver is active, the status line will display as follows: 

ACTIVE PRIHT DRIVER: PA 

NOTE: When using a custom print driver (see Appendix II), the "PA" command sets 
the printer DCB to your custom print driver. NOT the parallel driver Also see 
ACTUATING SPECIAL PRINT DRIVERS below. ' ° *** 

SMALL SY STEMS TRS-232 PRINTER PORT ACTIVE "TR" 

This command activates the Small Systems Software serial printer port This 

port is the cassette port or port 'FF' hex. When this port is active, the status 
line will display as follows: * 

ACTIVE PRINT DRIVER: TR 

RS232C SE RIAL PORT (UART) ACTIVE "UA" 

This command activates the standard RS232c serial printer port. When the 
serial port is active, the status line will display as follows: 

ACTIVE PRINT DRIVER: UA 

ACTUATING SPECIAL PRINT DRIVERS 

All print drivers loaded with the PLOAD command take over the functions of 
the normal parallel driver, no matter which port they output to and are actuated 
with the PA command. When you have loaded a print driver with the PLOAD 
command, the normal parallel driver cannot be reactivated. 
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ADDITIONAL NOTES - TITLING, NUMBERING & UNDERLINING 



TITLING PAGES and PAGE NUMBERING 

Pages may have title headings as in this manual by entering the following 

information at the beginning of the file onto the video display: 

$This is a Sample Title Heading <- 

| Start printing with the cursor here* 

In the above example, a dollar sign ($), MUST precede the title and "ENTER" MUST 
be typed after the title text. In order for the title to appear in printing as 
a title, printing MUST start with the cursor directly over the dollar sign ($) 
or follow IMMEDIATELY after a FORM FEED character. Otherwise, the title will be 
printed as regular text and will appear only once. 

If the title length is greater than the line length "LL" minus 10, selected 
in the SYSTEM MENU, the title text will appear on the printed page as regular 
text and the page number will NOT be printed. 

Whenever a title heading is used, pages will automatically be numbered at the 
extreme top right of each page. If page numbering is desired without a page 
title, only the dollar sign ($) is used. Printing must begin with the cursor 
directly over the dollar sign ($) or the dollar sign must follow a FORM FEED 
character. 

In the course of printing, title headings may be changed by placing additional 
title headings into the text. The Electric Pencil will recognize these ONLY if 
they appear directly after a FORM FEED character, a down arrow on the MODEL I 
and a diamond on the MODEL III. 



Start printing with cursor here, 

FORM FEED character 




The new title heading will then appear on all subsequent pages unless another 
title is inserted immediately after a FORM FEED. Page numbering will remain 
sequential throughout. The starting page number will always be 1 unless set 
otherwise from the PRINT MENU. 
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UNDERLIE I Hft 

StoSS underline 0KLY if y° ur Printer is capable of executing a carriage return 
WITHOUT executing a line feed. Most Selectric and some Centronic printers are 
not capable of underlining because of this requirement. 

There is no underline key on the TRS-SO. To generate the underline character 
hold down the <CONTR0L> key and press the <0> key once for each underline 
character you want to print. If you continue to hold down the <0> key it will 
repeat the character as long as you continue to hold BOTH keys down. 

EXAMPLE: enter the following example into the text buffer so that it looks like 
this: 



<- 



This is a test of the underline<- 

Now print it and it will look like this: 

This is a test of the underline 

Here is another example of an underline. Type it into the text buffer so that it 
looks like this; 

<- 



This is another underline test.<- 

Print it and it will look like this: 

This is anothex underline test. 

If these examples do not work on your line printer and you are sure that it is 
capable of underlining, turn off the printers "LOCAL LINE FEED". In this wav 
THE ELECTRIC PENCIL will control the printer's line feed and carriage return 
functions. On some printers (such as the Centronics MODEL 779) underlining will 
not be possible. 

Words or phrases may be underlined ONLY in lines shorter than the line length 
you have specified with the "LL" command AND terminated with an <ENTER> 
character. You may not underline a word or phrase within justified text without 
taking extraordinary measures to ensure that the underline is printed in exactly 
the right place. It is possible, but not advisable unless you eniov 
experimenting. J J 

To illustrate my point, the above paragraph has an underline embedded within 
justified text! It is just below the <ENTER> on the second line. It took me 
several minutes to set this up and the figure below is exactly how it appears 
on my video screen EXCEPT I have added the slash-b characters (f>) IN PLACE OF 
SPACES so you can SEE how many spaces are between letters. 



Words *Sor]6phrases|i)5may)ibeJJunderlinedli)SONLYt5inHines^shortert 
than|6the|6line|4length<- 

mmmmmmmwmwmwmmmmMmermini 

##)£)£ )S]A)6)i)S]i]S]SlijS <- 

you]i)ihavelft]6specifiedtiliwith)ij6the)ii4 rf LL 1l ^coinmandJStSAND 

M& M 16 Wa t e dtf 0w i t hji an Y> < EN TER>J4character.)ftYou]4may^no thunder line 

a)iwordt6or)4phrasei*within^justifiedtfttext)iwithout^takiiig 
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This example is particularly extreme because the underline appears at the very 
end of the line* The extra spaces required in order to cause everything to 
"space-out" correctly are very important and require some trial and error to 
work out. With a little experience you can come close on a first or second try 
but it's still tough. 

You will also notice that the "justified" line preceeding the underline line, 
is one character short of 80 characters and terminated with an <EKTER>. This is 
necessary since the line HAS to he terminated with an <EHTER> character and the 
program will count the <ENTER> character as part of the last character of the 
last word - if the line was one character longer, the word "length" would have 
been placed on a line by itself. I also had to justify the line myself, spacing 
the words so that they appeared to be justified. 

Needless to say, this is a complicated procedure but if it is absolutely 
necessary to embed an underline within text, it can he done... nothing is 
impossible! 
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SPECIAL TECHNIQUES, "TRICKS" & TIPS 

One of the things that makes a program like THE ELECTRIC PENCIL especially 

that PFNrrV a K iUty t0 US ! U f ° r a V " iety ° f P»»P"«. There are many uses 

I 2 l^t C1L CaU 1 ? e put , to and we wil1 explore some of these. There are probably 

some that you will think of yourself that are not covered here. This section 

will provide you with some ideas... the rest is up to you. 

WRITIMG BASIC PR OGRA MS USING THE ELECTRIC PENCIT. - (Disk systems) - This is an 
ea ! y TnA^* AU y ° U haVe t0 d ° is type in y0ur P ro £ram. SAVE it then go to BASIC 
?™rTT "° r T ^ 3S y ° U WOUU ^ ° tQer P ro ^am. The program you SAVE from 
program. " ^^ ^^ S ° y ° U "" MERGE U witb aD exifi t^S 

The advantage of writing a BASIC program in PENCIL is that you will have all 
of the advantages of a "full screen" editor. You can "crunch" (remove all 
S"" 3 BASIC pr0sram ^ usin S the SEARCH & REPLACE function of THE ELECTRIC 

._ r ^ u may also LOAD a program you have created in BASIC by SAVEing it with the 
AbLll option if you have a disk system. You will then be able to LOAD it into 
The ELECTRIC PENCIL without any other modifications to the program 

As a program text editor, PENCIL is also vary handy for making "global" 
changes such as changing all "PRINT" statements to "LPRINT" or changing variable 
£urpo S S est " PENCILI2ED " file Can also be "?""? I«"t.d« for documentation 

™fffffi* FIL f < " (DiSk 8 V 8tPm 8 > " VisiCalc is one of the most popular programs 
available, and for good reason: it works and performs many complex tasks. I? is 

ml EIECTPtV PPMr?T Pr °r SSOr f ° r numberS " or P erha P s a "««*«r processor". Like 
THE ELECTRIC PENCIL, its uses are many and varied. Of course you can save a 
iilrrf / Ue USlng the " data interchan se" format and load it into THE ELECTRIC 
PENCIL and work on the "output file" as if you had created it using a word 
processor. That's an obvious use of the THE ELECTRIC PENCIL/ VisiCalc 
combination. The following is not. 

THE ELECTRIC PENCIL can also be used to make listings of your VisiCalc 
formula entries to each row and column. I know that I wanted to get listings of 
the various formulas I had entered into my VisiCalc program. The only provision 
that VisiCalc has provided for this is to display your entry in the upper left 
hand corner of the screen when VisiCalc' s cursor is on a particular row and 
column. About the only way you could get a listing of your formula entries is to 
copy them by hand as you scan the cursor over the "electronic worksheet" 

Have heart, 0- stalwart knight of the keyboard, there are ways and they are so 
simple I First of all, you must understand how VisiCalc saves its files: they are 
plain vanilla ASCII files. Each row-column position is stored with all of the 
information pertaining to that row-column position and terminated with a 

»nnc la i!n" tUra * F ° r starters » tak * a VisiCalc file you have saved and from the 
DOS READy" message type: 

H0DEL_I MODEL TTT 

PRINT filename/VC<ENTER> LIST filename/VC (PRT,ASCII)<ENTER> 

or or 

LIST filename/VC<ENTER> LIST filename/VC (ASCII )<ENTER> 

"LIST-^n,"' /^ St T C '- " PRINT " WU1 Sen ° the listil * to the line P"«er and 

sought "Ji Vh "'% llSting t0 thC Vide ° dis P la y* That wiH &ive you the long 

sought tormuia " listing. * 
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Another way of listing your original VisiCalc entries is to simply load the 
file into THE ELECTRIC PENCIL* Simply use the full file name when you load it 
into PENCIL. Be sure include the file name extension* The file will load and you 
can alter it, list it using THE ELECTRIC PENCIL'S print function or create 
VisiCalc source files. 

VisiCalc saves its files beginning with the lower right most entry, working 
from right to left and bottom to top. When ail of the row-column entries have 
been saved, it then saves its "global" program-display parameters. 

For this illustration I will use a nonsensical- simplistic example but you may 
enter larger and of course s more meaningful entries for your own experiments. 



VisiCalc "source" 




File 


Comments 


>D5:@SUM(A3...D3) *. 


* . , « Row 5 entry 


snA * " 


. • * . Kow 4 entry 


^L/tf * — — — ~ — — — - - —,— ^ ^ 


>B3:@SUM(DK..Ifi) 




>C3:@SUM(Ci...C2) 


¥ . , , Row 3 entries 


>B3:@SUM(B1...B2) 




>A3:@SUM(A1...A2) , 




>D2:+Dl/.7789 1 




>C2:+(Cl*22)/45 


y .. , Row 2 entries 


>B2:+B1*15.77 




>A2:+A1*56.88 j 




>D1:/FI9.66 




>C1:/FI6.77 


> •- . Row 1 entries 


>Bl:/Fl35«4055 j 




>Al:/FI23.156 | 




/Wl 




/GOC 




/GRH 


> *.- Display/global 


/GFG 


parameters 


/GC9 




/X>Al:>Al: 





The above VisiCalc "source 11 file will load and display just as if you had used 
VisiCalc to create it. (Do not enter the comments on the right and be sure to 
enter a carriage return at the end of each row-column entry.) It is possible to 
enter the VisiCalc "source" file in any order, such as an "inverted" order as 
follows : 

>A1: 

>A2 

>A3 



>D5: 



Since this is not exactly how VisiCalc expects to receive the file, it will load 
slower than molasses on a cold winters morn but VisiCalc will eventually sort 
out the mess you have created and put everything in its correct place. 
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Here is the VisiCalc notation format 

ROW COLUMN ENTRIES 

Beginning of 
source line* 



End of source line (0D HEX) 
J Not shown) 



Row/column position senerator 
E 

>Al:+456.67 

tt t 

f Source entry 

Row number 



_ Column number 

In the below example, »/FI" has been added to the source line. This denotes that 
the display is to be in INTEGER format. denotes that 

>A1:/FI456.67 



a next example there is no formula or numerical data, instead there are 
characters that are to be treated as a "label". The VisiCalc program 

that a row/Column fiplrl i c a TI 1 Q H Q 1" k _- ^ . ., r & 



In the 

alpha cl 

f, Lrnr.TTc" *. w « *- "i~ i" \- , . 7. ~~ " ---!_*. • inc viiiLaic program 

as shovn: * r ° W/C ° 1Umn fXeld " a label " beca ^ it "arts with quote Jrks 



Quote indi cates that data record is a "label" 
>Al:"This is a test 

set^ 1 ""^ 1 ^ th / 1 VisiCalc loads " e the display/global parameters. These 
set the window mode, the global re-evaluation mode, recalculation mode format 

TrelLtl T "if* Si CUrS ° r P ° fiiti0n * The ™w-coW source statements ™« 
preceded by the »>" character. This information is preceded by the slash »/» 
character. The format for this information is as follows: ' 



/Wl 

/GOC 

/GRM 

/GFC 

/GC9 

/X>A1 : >A1 ; 



- Window mode = '1' (normal display) 

- Global revaluation mode = Column 

- Global recalculation mode - manual 

- Global format mode = general format 

- global column width = 9 

- Cursor position coordinate 



Remember, eacn of the above "data records" is terminated with a carriage 

If the thought has not yet occurred to you, then let me give your creative 
juices . jab - THE ELECTRIC PENCIL is an excellent » da ta recovery" to" for 

«c£tru« , TV * If , ^ " l0Se " 3 ValUabU VisiCaU fil " acd need to 
Mysteries" ,L T, "■"* the meth ° dS Z have out ^"« » "TRS-80 Disk & Other 

then use PEKCIT r« * "T" t0 "* " teBt ^ y ° U CaD L0AD U int0 PEKCIL aad 
cnen use PEKCIL to reconstruct the missing parts I 

here°is .^t.^ 1 ^ f ° r ^ y ° U VisiCaLc fans that h «« lost a file in memory, 
uere is a restart address you can use: 6906 HEX. 
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EMBEDDED LIKE PRINTER CODES - This little trick will work on disk, tape and 
Stringy Floppy Systems. True, it is a seemingly 'clumsy' way to embed printer 
codes, but it works never the less. Of course you will need a "smart" printer 
like an Epson, Qume, Diablo or NEC that will respond to the embedded printer 
codes. Since each printer has a different set of codes to do the same things or 
different things, it is not possible to make a "universal 1 * printer code file, I 
will tell you how to create your own. But first, let me tell you how it works. 

In order to "talk" to the printer without having it print something, we have 
to send it a special character, then what we send it will be interpreted as an 
"instruction' and not a character. Usually this is the "escape code" character - 
in English, this means that it is an ASCII character with a code number of 27. 

Following the "27" there are usually one or more additional characters that 
the printer will interpret as the actual instruction and finally, a carriage 
return which will signal the printer that we have completed our instructions to 
it. 

Here is a typical conversation between your computer and printer: 

HUMAM: Here is something I want you to send to the 

printer: LPRINT CHR$(27) ;CHR$(125) ;"J"<ENTER> 



Hey guys s wake up - we have something coming in. 



COMPUTER; 

OPERATING 

SYSTEM; Yes, wait a nanosecond - it looks OK to me - no 
syntax errors. Hey video, display this, OK? 

VIDEO: Got it. Its up on the screen. 

COMPUTER: All right then, I'll send it to the printer. 

Hey, printer! Are you ready to print something? 
(Sends a "request to send data" signal) 

PRINTER; Yeah, I'm ready. Send it, (Sends a "data terminal 
ready" signal) 

COMPUTER: OK, here it is. Here is an ASCII code 27. 

PRIKTER: Thanks. Waitaminute. I can't print this, its a 

code that means I'm supposed to set myself up for 
something else. 



COMPUTER; Right I Here is the next code, its an ASCII 125 
PRIKTER: Thanks again, but what else is there? 

COMPUTER: Well, I have a letter "J". 
PRINTER: Fine, fine, anything else? 

COMPUTER: Yep, here is a carriage return, an ASCII 13. 
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PRINTER: OK, then THAT'S the end of it. Now let's see, I have 
a 27, a "125" and a "J". Hmmmm, that means that I 
am supposed to set my line spacing to ten one 
hundred twentieths of an inch per character typed* 
Thanks, computer* Give my regards to your human* 

COMPUTER: Sure thing. OK system, send a "READY" to the video 
so the human will know that everything is OK. 

OPERATING 

SYSTEM: Coming up. Video? 

VIDEO: Video ready* 

OPERATING 

SYSTEM: Print a "READY" for the human. 

VIDEO: Roger the "READY". Now what? 

COMPUTER: That's it. Now we wait and see if he wants to do 
anything else. Keyboard scan — be alert in case 
he types anything. 

KEYBOARD: Roger. I'm waiting. 

HUMAN: Hey, Charlie, The line printer is set for 12 char- 
acters per inch do you want me to list this 
program? 



With this little exchange, the printer is set to print 12 characters per inch 
elite spacing. This particular code is for a NEC printer. Your printer codes 
will probably be different. The process is simple enough but the problem is; how 
do we send these codes to the printer from THE ELECTRIC PENCIL when THE ELECTRIC 
PENCIL cannot generate ASCII codes below 32 and above 12 4? 

The answer is obvious - we simply make a file with all these codes in them 
and use the BLOCK MOVE to put them where we want. (Did I see a light bulb appear 
over your head?) So, now we know WHAT to do, let's look at HOW we can do it. 

THE ELECTRIC PENCIL text files are plain vanilla ASCII files. Each byte of a 

normal" ELECTRIC PENCIL file contains the ASCII code for each byte of the text 

file you originally had in memory. Carriage returns are stored as an ASCII '13' 

which is the normal ASCII character for a carriage return. THE ELECTRIC PENCIL 

puts an ASCII code *D0' at the end of each file. The conclusion here is that 

what you see is what you get. It's simple and straight forward. 

Now that we know the format of the file here is how we generate it. We 
simply write a BASIC program that will make an ASCII file, with the codes in it 
that we want, and then load it into THE ELECTRIC PENCIL WHEN WE WANT TO USE IT! 
Here are two programs. The first is for a disk system and the second is for 
tape. The tape or the disk version can be adapted to create a data file on the 
Stringy Floppy with little or no trouble. 

Since the first task that must be accomplished before you can do this 

trick is to create the codes that we will embed into the text. Go to BASIC 

and enter this program or enter it into THE ELECTRIC PENCIL. Remember, do not 

forget to put a carriage return at the end of each BASIC line and to SAVE the 

program with the cursor over the "1" of the "10". 
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DISK VERSION 



REM ************************************************ 

20 REM ELECTRIC PENCIL PRINTER CONTROL FILE - DISK 

30 REM PROGRAM: CODEGEN 

4 ° REM FILENAME: PRINTCTL/PCL 

50 REM ************************************************ 

60 REM 

70 CLEAR 1000 : CLS 

80 PRINT@448, "WORKIN' HERE BOSS " 

90 0PEN"0",1, "PRINTCTL/PCL" 

100 FOR X=l TO 31 

110 PRINT#1, "ASCII CODE";X;" >";CHR$(X) ;CHR$(13) 

120 NEXT X 

130 FOR X = 91 TO 2 55 

140 PRINT#1, "ASCII CODE";X;" >";CHR$(X) ;CHR$<13) 

150 NEXT X 

160 PRINTS, CHR$(00) 

170 CLOSE 

180 PRINT@448, CHR$(31J; "ALL DONE HERE BOSS..." 



TAPE VERSION 

10 REM ************************************************ 

20 REM ' ELECTRIC PENCIL PRINTER CONTROL FILE - TAPE 

30 REM PROGRAM: CODEGEN 

40 REM 

50 REM ************************************************ 

60 REM 

70 CLEAR 1000 : CLS : PRINT@ 468, "READY CASSETTE U PRESS ANY KEY" 

80 IF PEEK (14591) = THEN GOTO 80 

90 PRINT@448, CHR$(31) j'VORKIN' HERE BOSS " 

100 FOR X=l TO 31 

110 FRINT^l, "ASCII C0DE";X;" >";CHR$(X) ;CHR$(13) 

120 NEXT X 

130 FOR X = 91 TO 2 55 

140 FRINT^l, "ASCII CODE";X;" >";CHRS(X) ;CHR$(13) 

150 NEXT X 

160 PRINT^l, CHRS(00) 

170 PRINT @448, CHRS(31);"ALL DONE HERE BOSS..." 



Rim it t/ ?r e Pr ° 8 f a ? SaVCd ° at ° the disk ' (or ta P e) > g° t0 BASIC and 
RUN it. It will create a file which will be called "PRINTCTL/PCL". When that 
file is created, return to THE ELECTRIC PENCIL and LOAD the PRINT/CTL file. You 
will now have a file that looks something like the next figure. I say 
something" because I am unable to print all of the characters that you can see 
on your video screen. I have had to make an APPROXIMATION of that file and of 
course, the figure below is much shorter than the actual file that you will 
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ASCII CODE 94 
ASCII CODE 96 
ASCII CODE 123 
ASCII CODE 124 
ASCII CODE 125 
ASCII CODE 126 




The next task is to find out if any of the characters in this file make 
your printer go crazy. So we will have to print the file on the line printer. 
The first thing you will notice is that the first seven ASCII codes cause the 
program to stop printing. Skip these, one at a time if you wish - until the 
r^" te » W lU . continue t0 run to the next line. You can also eliminate the ASCII 

«- k L 81 ^ e " the d0Wn arrOW and wiU sim P l y P riDt a FORM FEED. There 
may be other characters you will want to eliminate after printing the file Once 

f??* %?l K narro * ed it^own to the characters you want to keep, then construct a 
tile that has the printer control functions with similar codes grouped 
together. Once again, I will have to use an approximation of what my file looks 
like but it s something like this: 



FILE: PRINTCTL 




SET TO 9 CPI — 


> ©>M 


SET TO 10 CPI — 


— > e}L 


SET TO 11 CPI — 


> 6}K 


SET TO 12 CPI — 


> 6} J 


SET TO 13 CPI — 


> 0}I 


SET TO 5.LPI — 


— > e}x 


SET TO 6 LP I — 


— > 6}W 


SET TO 7 LPI — 


> 8}V 


SET TO 8 LPI — 


— > e}u 


SET TO 9 LPI — 


> 6}T 


SCRUNCH PTTA -~— 


«_. "^ alvalv 




~—~> O/JLO/K 


UNSCRUNCH PICA — 


— > 8>ue}j 


SCRUNCH ELITE 


— > e}ve}i 


UNSCRUNCH ELITE - 


> 6}W6>L 


SPECIAL CHAR ON - 


-> B 


SPECIAL CHAR OFF 


-> 


SET LEFT MARGIN - 


— > 6M 


RESET LEFT MARGIN > dQ 


HORIZ TAB 


-> eej 


VERTICAL TAB ~FWD> 6Z@ 


VERTICAL TAB — REV> 6YZ 


CARET MARK 


■> A 


LEFT APOST 


■> x 


LEFT BRACE 


■> { 


VERTICAL BAR 


•> 1 


RIGHT BRACE 


■> > 


WIGGLE 


■> ~ 
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In order to make the various combinations of codes necessary for the above f ile, 
I used THE ELECTRIC PENCIL'S block move capability to "build" the codes. For 
instance, my NEC printer manual says that an ESC(ape) "Y", "Z" will cause the 
printer to do a reverse vertical tab of 58 lines. This particular command was 
easy because all I had to do was add the "Y" and "Z" to the ESCAPE code (ASCII 
27) and violal A reverse vertical tab was born. 

A more complex code was "SCRUNCH ELITE", Here, there are actually two codes 
for my printer* One to squeeze the letters closer together (13 characters per 
inch) and one to squeeze the lines closer together (7 lines per inch). I should 
point out that normal elite line spacing is 8 lines per inch but, that was too 
close for me - it made the text look "too black". 

The code to set the letter spacing for my NEC printer, is: 

ESCAPE + ASCII code 12 5+1 
The code to set the line spacing for my NEC printer is: 
ESCAPE + ASCII code 12 5 + V 

First I built the ESCAPE and the ASCII code 12 5 and added the letter "I" to 
it. Then I duplicated that and changed the M I" to a "V M . Finished. Using those I 
created the rest of the codes that I might commonly use. Those that I never 
used were eliminated from the file and later some were added. 

You will have to create a file to fit your needs and your printer. 

One word of caution: THE ELECTRIC PENCIL will count the embedded characters 
as if they were regular characters and for that reason, you may find that you 
will have to go to some extraordinary lengths to make a line appear 
"justified". 
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SPECIAL "TRICKS" 

DOUBLE STRIKING - (MED IUM BOLD FACE CHARACTERS) When THE ELECTRIC PENCIL is 
set for underlining, it does not count any lines with the underline character(s) 
in it. We can use that to our special advantage for making double strike letters 
and letter combinations. Here is an example of "double strike" letters: 

THIS IS AN EXAMPLE OF MEDIUM BOLD FACE. 

In order to do this bit of "magic" I caused the line to be printed three times, 
inis was done by using the underline character in front of each line The 
underline character was printed but, before this manuscript was sent to the 
printer, I simply WHITED OUT the underline character. It originally looked like 
this, on the paper (note the underline character): 

M_ THIS IS AN EXAMPLE OF MEDIUM BOLD FACE. 

It will look like this on your video screen: 

_ THIS IS AN EXAMPLE OF MEDIUM BOLD FACE. 

__ THIS IS AN EXAMPLE OF MEDIUM BOLD FACE. 

THIS IS AN EXAMPLE OF MEDIUM BOLD FACE. 

EXTRA BOLD FACE LETTERS - This is a mixture of the above. First we will Drint 
wfon 1 ^ 6 Wlth th£ underline character then we set the printer so that it spaces 
l/120tn of an inch per character, print one space at that setting, then reset it 
for normal spacing and then print the line again. The results will look like 
this: 

1HIS IS AN EXAMPLE OF EXTRA BOLD FACE. 

This is how it will look on your Video screen: 

_ THIS IS AN EXAMPLE OF EXTRA BOLD FACE. 
6}A 6} J _ THIS IS AN EXAMPLE OF EXTRA BOLD FACE. 

It is obvious that the screen is quite different from the final printed version 
The lower line with the embedded codes is off- set from the upper line. This is 
because printer control characters are not printed by the printer but are 
printed by the video. Therefore our video display does not correspond to the 
final product. 

You will also notice that there is a SPACE between the two printer control 

codes. This is absolutely necessary. If we eliminate the space, we will not get 

our l/120th of an inch off- set that makes our double strike letter appear bolder 

and two spaces are too many. This same trick can also be used to make 

double- strike" characters such as a slasta-"b": 

$ 

With a little creative thinking on your part, you can print multiple columns per 
page -just like a newspaper, "scrunch" your text for newsletters, make bold 
race headlines and so on. A little experimentation and who knows what you'll 
come up with. } 
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GOOD COMPUTER PRACTICES 



There is nothing that is more aggravating than losing an important text file or 
diskette. There are several methods for recovering important data on the 
diskette and sometimes , from memory, but these techniques are extraordinary. 
This type of data recovery is covered in "TRS-8G DISK & Other Mysteries' 1 by H.C. 
Pennington and is available from most book stores, computer stores and from IJG 
directly. 

Our discussion here will simply concern some rules of good computer 
practices* In writing this manual, the text files were saved on diskette. It 
would have been a disaster of the first order if we had saved our files to only 
one diskette and through some trivial accident, had the diskette "zapped* 1 with 
static electricity, put a dent into the diskette, touched the diskette's 
magnetic coating with a finger after eating a taco, had a power failure in the 
middle of a SAVE or had one of a thousand things go wrong. 

One sure way of preserving your work is to save your files OFTEN ! However, 
even that sometimes does not save you from disaster. So, I will tell you how I 
avert disaster and the rest is up to you. 

GENERAL RULES 

1. Wash hands BEFORE handling diskettes. DO NOT use hand lotions AFTER 
washing your hands. I suppose that you could get away without washing your hands 
but one SPECK of oil or grease after accidentally touching the diskette's 
magnetic media will cause it to become UNREADABLE by the computer. 

2. NEVER use paper clips on diskettes. These cause the diskette to become 
deformed and possibly dented. Paper clips that have been in magnetic 
clip-holders can also retain their magnetism and may cause "electrical damage" 
to the diskette. 

3. Remove ALL magnetic gadgets from the word processing area. Magnetic 
paperclip holders, magnetic calendars, and magnetic paper holders. These little 
desktop decorations and office aids can cause IRREPARABLE damage to diskettes. 

4. NEVER place diskettes near a telephone. Telephones have magnets and 
transformers in them. 

5. NEVER place diskettes OR DISK DRIVES on the left side of a MODEL I 
computer (MODEL III is OK) as the video flyback transformer is on this side of 
the unit. This transformer radiates a strong high frequency magnetic field and 
will raise hell with your disk drivers electronic parts* It may also cause 
diskettes to become unreadable 1 (Cute, huh?) 

6* Treat diskettes with respect. Diskettes are cheap. Data is expensive. Why 
jeopardize EXPENSIVE and VALUABLE data by trying to save a couple of bucks on 
diskettes? 
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BACKUP PROCEDURES 



''Backing up" a diskette is the best insurance you have for preserving data, If 
one diskette is lost, you will have the back-up copy to fall back on. Of course, 
any new material you have added since backing-up the disk will not be there but 
on important files this usually means that you will only have to retype the 
additions or changes. 

Most people only make one back-up copy of their diskettes. Inmost cases this 
xs OK but on important data this can lead to trouble, Let me illustrate the 
problem and then we'll talk about ways to avoid it. 

Suppose you have this extremely valuable data (such as this manual) stored on 
diskette. If you were to lose the diskette you would lose a couple of months of 
work in one fell- swoop. So, to prevent that, you back-up the data every couple 
of days. In two years of working with the computer this has always been 
sufficient. You have never had any problems that couldn't be overcome by using 
the back-up copy of the diskette. 

One dry and windy day, you are working on very nearly the last chapter of 
the manual and performing a SAVE. While the program is writing the file to the 
disk, you get up and fetch yourself a cup of coffee. As you walk to the kitchen 
(if you are at home) or to the coffee area in the office, you pick-up a static 
charge while walking across the carpeting. No big deal, you do it all the time. 
Halfway to the coffee pot, you remember that you left your coffee cup next to 
the computer and return to get it. You reach across the keyboard ... ZAP I There 
is a MINIATURE lightning strike as your hand brushes against the keyboard. The 
disk is still spinning. Oh well, nothing seemed to go wrong. In another couple 
of seconds you see the message, "FILE SAVED" 

You abandon your plans for coffee and immediately inspect your file in 
memory. Scrolling through the text, you don't see anything wrong. Just to be 
sure, you clear the memory and try to RELOAD the file. The disk runs and runs 
and runs. Nothing. Finally, you get the message, "DOS ERROR CODE 04". You look 
in the TRS-DOS Disk Manual to discover that an error code "04" is a "parity 
error during read". 

You try to LOAD the file a few more times and get the same error. Alright, 
the damn disk is flaky, you conclude and resign yourself to putting in the 
back-up diskette, reloading the file, and re-entering your additions and 
changes. The back-up diskette is inserted and the file loaded. So far, so good. 

What you do not know is that had you CAREFULLY inspected your file in memory, 
when it was first "zapped", you would have noticed an occasional strange 
character here and there. Since these "strange 11 characters were scattered 
through the file here and there, they escaped your attention. What this means is 
that random bytes of memory were "zapped". It also means that unbeknownst to 
you, memory that you could not see was also "zapped". 

"So what," you say. Here's what. Some of that memory was memory used by the 
operating system that invisible group of programs that make the computer 

smart". It was that part of memory that caused the parity error on your 
diskette. What is worse, is that IT HAS NOT BEEN CORRECTED 1 It is still 

zapped". 
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Continuing with our story by now you have once again added your changes 

to your file and once again, you SAVE it. In fact, you save it several times t 
while you are composing your additions and changes. After a while you finish* 
Its late and you decide to print out the file tomorrow* 

The next day, you decide to back-up your files. The diskettes are inserted 
and the back-up command is initiated* After a few seconds you get another one of 
this mysterious messages » "FUNCTION TERMINATED - ERROR DURING READ". Now you are 
in trouble. The original back-up diskette was zapped yesterday and today your 
master copy will not back-up. What happened? 

Its simple. After each save yesterday* the disk input/output software was 
making errors on the disk. That part of the software that computes the "parity" 
was zapped so that it computed a different parity than that normally used by the 
system. Today, when you "booted-up" your computer, the "zapped" disk routines 
were replaced with the correct routines. Now, the system is unable to read your 
diskette! 

No amount of swearing and cursing is going to get it back. You can resort to 
the "extraordinary" methods mentioned above but you have probably avoided 
reading any of that "technical stuff". Now your master diskette is unreadable 
and so is your back-up copy! 

Here is how to avoid a story like the one above. 

1. NEVER use a master diskette AFTER you have wiped out the back-up. Always 
SAVE to a standby diskette and transfer the file to the master later - AFTER you 
are sure that everything is OK. 



2 . Use this back-up me 
1 day 



day 
ago 





^back-up youngest diskette 
the oldest diskette... 

...and figuratively move each disk one place to the right. Now disk "A" is a 
duplicate of disk "D". Anything we put on disk "A" will not affect the work that 
we did "yesterday". Just to keep things straight relabel the diskettes A - D and 
repeat this procedure each time you start a new entry session. 






These two diskettes are now duplicates 
use "A" for "today's" entries. 
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If you will keep up this "round robin" method you will NEVER LOSE the entire 
diskette because you are always covered with back-ups that span several days. 
So, always back-up the "youngest" disk to the "oldest". Some of you will use 
three diskettes and some will use only two... whatever you choose, just remember 
that the more important the information is, the greater back-up depth you should 
use. 

Another protection technique that I use is to always use two "scratch files" 
when I am working on a file. All of my SAVEs are to "SCRATCHl" and "SCRATCH* " 
while I am working. Then, when I am through for the day, I save the file to the 
correct file name. With this technique, even disastrous editing mistakes that I 
make myself are avoided. 

The next dragon to rear its ugly head, is the destruction of diskettes as a 
result of a hardware problem. If you simply take your backup and stuff it into 
one of the drives, you will lose it. To prevent this, ALWAYS write protect your 
master diskettes when there is a problem. Then make a "temporary" back-up of the 
good disk and work on the "temporary" until you have resolved the problem. 

If you are careful, you will always be covered and you should never have to 
resort to extraordinary measures to reclaim "lost" data. 
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THE ELECTRIC PENCIL MESSAGES 



There are two types of messages: (1) error messages and (2) information 
messages. 

Information messages inform you that some operation has been successfully 
completed, or there is a condition that you should be aware of, but is not an 
error. Error messages inform you of an error condition that has occurred while 
performing some specific operation. 

The following messages are in alphabetical order* 



BREAK - An information message issued when the <BREAK> key has been pressed 
during a tape or Stringy Floppy operation. Portions of any file loaded or saved, 
up until the time the <BREAK> key was pressed, will be in memory, on tape or 
Stringy Floppy. 

- Where 'xxxx' is a search string, from one to 



thirty-eight characters long, that could not be found during any SEARCH and 
REPLACE function. The screen is cleared and the message appears center screen. 
Press any key to return to TEXT ENTRY mode. 

DISK DRIVE UNAVAILABLE - An attempt to SAVE, LOAD, KILL, or do a DIR to a 
specific disk drive which does not exist or to a drive that has an open door. 

DISK FILE KILLED - An information message issued when a file has been 
successfully killed or removed from the diskette's directory. 

DISK FILE LOADED - An information message issued when a file has been 
successfully loaded from the diskette* 

DISK FILE WOT FOUND - A LOAD from diskette cannot be completed because the 
requested file cannot be found on the system. The message appears in the command 
line. Recover by inserting the diskette containing the file into an available 
disk drive and re- issuing the LOAD command. 

DISK FILE SAVED - An information message issued when a file has been 
successfully saved to the diskette. 

DISK FULL - An attempt to SAVE a file to a diskette that has no more room in 
which to store a program. CAUTION: Since part of the file may have been saved it 
is advisable to KILL that file and save it to a diskette with sufficient room. 

DOS ERROR nn - An information message issued when a DOS error has occurred, 'nn' 
is the error code of the error. See TRS-DOS Disk Manual for error codes and 

their meanings. 

ESF DRIVE HOT AVAILABLE - An information message issued indicating that the 
requested Stringy Floppy Drive is not on line. 

FILE AREA FULL (TEXT MODE ) - All available memory has been used. The screen is 
cleared and the message appears center screen. Press any key to return to TEXT 
ENTRY mode. Recover by deleting text or saving the file and starting a new 

file. 
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FILE AREA FULL (SYSTEM MENU Mnnr.1 - All available memory has been used as a 
result of a file, from tape, stringy floppy, or disk, filling or exceeding the 
buffer size. Press any key to return to TEXT ENTRY mode. Recover by deleting 
text or saving the file and starting a new file, 

FILE SAVED WITHOUT P RINT VALUES - An informational message issued after a save 
to tape, stringy floppy or disk when the print values are off (FVOFF). The 
message appears above the "copyright" line. 



LOCATED 



nnn TIMES - Where 'xxxx' is a search string and 'nnn' is the 



number of times the search string was located during a SEARCH only function. The 
screen is cleared and the message appears center screen. Press any key to return 
to TEXT ENTRY mode. 

MARKER ERROR - There are too few or too many BLOCK MARKERS or there is no text 
between markers, in the text file, when a block move is attempted. The screen is 
cleared and the message appears center screen. Press any key to return to 

ENTRY TnnHo. 



ENTRY mode. 



TEXT 



MEMORY FAULT - An information message as a result of an error in memory detected 
by the operating system (DOS error code 35). This is usually as a result of a 
transient electrical problem or unstable memory. 

Np DRIVER IN HIGHMEM - An information message issued when the command, "FSAVE 
filename :d" is used, indicating that the print driver has not been properly 
initialized. 

NO FILE EXISTS - This message is issued under two circumstances and appears in 
the COMMAND LINE of the SYSTEM MENU: 

1. When an attempt is made to LOAD a "null file" from disk. This is a file that 
has a file name but has no contents (physical records = zero). The message 
appears in the COMMAND LINE of the SYSTEM MENU. 

2, When an attempt is made to save a file to tape, Stringy Floppy or disk and 
the cursor is at the end of the file or there is in fact, no text file. 

OVERLAY FILE FENCILn n/SYS NOT FOUND - Where 'nn' is the number of an Electric 
Pencil system overlay. (01 - 02 - 03 - etc.) . Message is issued when Electric 
Pencil cannot find its system overlay on the system. The screen is cleared and 
the message appears center screen. Press any key to return to TEXT ENTRY mode. 

OVERLAY FILE PENCILn n/SYS NOT LOADED DOS ERROR nn - Same as above except that a 
DOS error may have been the cause of the Electric Pencil system file not found 
condition. 

PENCIL04/SYS SETUP FILE SAVED - An information message issued when the command, 
"SETUP" is used, indicating that the SETUP file (PENCIL04/SYS) has been 
successfully transferred from memory to diskette. 
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PRESS ENTER TO DELETE 1 CHARACTER AT END OF FILE & DISPLAY TEXT - An unusual 
condition due to lines of full screen width, without spaces, that do not have 
carriage returns at the end of the lines and the text buffer is full. (FILE AREA 
FULL condition}* The screen is cleared and the message appears center screen. 
Press any key to return to TEXT ENTRY mode. One character will be deleted from 
the text and the line will then be displayed. This may happen multiple times. 

Recover by putting carriage returns at the ends of the long lines; by 
inserting spaces in the long lines or by reducing the amount of text in the 
file. 

PRINT DRIVER CANNOT BE LOADED WITH TEXT IN FILE SAVE & CLR FIRST - An informa- 
tion message advising you that you must save your current text file, in memory, 
then clear memory, with the CLR or CAA command, before a print driver can be 
loaded. This is necessary because the print driver may require additional memory 
space currently occupied by your text file. 

PRINT DRIVER LOADED - An information message issued when the command, "PLOAD 
filename :d" is used, indicating that the print driver has been successfully 
loaded from diskette. 

PRINT DRIVER SAVED - An information message issued when the command, "PSAVE 
filename :d" is used, indicating that the print driver has been successfully 
transferred from memory to diskette. 

PRINT REQUEST TERMINATED - LINE BELOW EXCEEDS PRINT LENGTH - A line of text 
cannot be printed because there are insufficient spaces within the line to 
permit the print routines to shift the word to the next line. The screen is 
cleared and the message appears center screen. Press any key to return to TEXT 
ENTRY mode. 

Recover by inserting spaces into the line or by making the line length 
setting (LL) longer. 

PRINT VALUES WILL BE USED - An information message issued when the command, 
"PVON" (Print Values ON) is entered in the SYSTEM MENU mode. The message appears 
in the COMMAND LINE of the SYSTEM MENU. 

PRINT VALUES WILL NOT BE USED - An information message issued when the command, 
"PVOFF" (Print Values OFF) is entered in the SYSTEM MENU mode. The message 
appears in the COMMAND LINE of the SYSTEM MENU. 

PROTECTED DISK FILE - This message is issued under two conditions and appears in 
the COMMAND LINE of the SYSTEM MENU. 

1. A LOAD from diskette cannot he completed because the requested file is 
password protected* The message appears in the command line. Recover by issuing 
the LOAD command with the file name and password. 

2 . A LOAD from diskette cannot be completed because the requested file has a 
sector in which the sector ID marker has been changed to "protected status". 
This is an error caused by the operating system, the hardware or both. The 
message appears in the command line* Recovery may be attempted by using a disk 
utility program, such as SUPERZAP, (Also see TRS-80 DISK & Other Mysteries by 
H.C. Pennington, IJG $22.50 - available at most book stores and computer 
dealers.) 
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REPLACED "sxxx" nan TIMES - Where 'xxxx' is a search string and 'mm* is the 

RE^Icf LJS" I? 16 - eS " h Strln8 W3S 1<>Cated Snd re P laced d "ing a SEARCH and 
REPLACE Unction when nnn is a number tower than the requested number of 
replacements. The screen is cleared and the message appears center screen. Press 
any key to return to TEXT ENTRY mode. 

STRINGY FLOPPY FILE KHABKT) nnnnn RYTFS - An information message issued after an 
©JEW operation, where 'nnnnn' indicates the number of bytes, on that S trine* 
Floppy wafer, available for storage. 

STRINGY FLO P PY FILE T.OAP E!) - An information message issued when a file has been 
successfully loaded from the Stringy Floppy wafer. 

STRINGY FLOPPY FILE SAVED - An information message issued when a file has been 
successfully saved to the Stringy Floppy. 

jj TRINGY FLOPPY NOT AVAILABLE - An information message issued when a Stringy 
the system 100 " reqUESted and there is no Stringy Floppy drive attached to 

enter^d E incor rectly arS " ^ PRIKT "^ "* SYSTEM ^ **" & Commaud has been 

. TAPE ERROR - The system has detected a checksum error during a tape loadine 
operation. Any text loaded, previous to the error condition, will be in memory? 

TAPE PILE LOADED - An infoimation message issued when a file has been 
successfully loaded from the cassette tape. 

TAPE FILE SAVED - An information message issued when a file has been 
successfully saved to the cassette tape. 

TAPE FILE VERIFIED - An information message issued when a file has been 
successfully verified. 

TAPE TOO SHORT - An information message issued during an @SAVE operation, when a 
tile will not fit onto a Stringy Floppy wafer. Recover by using a Stringy Flonnv 
wafer of greater length, to save your file on. 

TEXT IN MEMORY CANNOT BE RECOVERED PRESS ENTER TO CONTINUE - Message is issued 
*» e % 3 lZ St t Tt ° f the ELECTRIC PERCIL was attempted with the command, "PENCIL 
recovering ^ *"' *" **** ^'"^ " m6m ° ry and U not 

Press ENTER and a normal entry to ELECTRIC PENCIL will be made. 

WARNING: CURS OR NOT AT BEG INNING OF FILE ONLY PART OF FILE SAVED - A warnine 
message issued from the SYSTEM MENU that appears in the "copyright" line. 

WRITE PROTECTED DTSK - A SAVE to disk cannot be completed because the diskette 

T th! r iv^M te ^ M n ab r" the n0tCh ' ThC me66a 8 e a PP ea « in the COMMAND LINE 
or tne SYSTEM MENU. Recover by removing the write protect tab and saving the 
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APPENDIX I 



GLOSSARY 



Words that may be new to you are included in this glossary* Commonly used words 
that may have a special meaning in the context of word processing are also 
included. We have also included words that are peculiar to the operation of a 
computer in general* Since you may see reference to them in other manuals, 
publications and in discussions concerning the computer or TEE ELECTRIC PENCIL 
word processing system, 

ABORT - To cease or halt an operation without processing any more data. 

ACCESS - The operation of seeking, reading or writing data on a storage unit 
such as the disk or tape drive. 

ACCESS TIME - The time that elapses between any instruction being given to 
access some data and that data becoming available for use. 

ACRONYM - A word formed by combining initial letters or syllables and letters of 
a series of words for a compound term* CIA is the acronym for "Central 
Intelligence Agency". 

ADDRESS - An identification (number, name or label) for a location in which data 
is stored. 



ALPHANUMERIC (CHARACTERS) - A generic term for numeric digits, alphabetic 
characters, punctuation characters and special characters. 

ASCII - Acronym for "American Standard Code for Information Interchange"* 
Pronounced; Ass-KEY. Usually refers to a standard method of encoding letter, 
numerical, symbol and special function characters, as used by the computer 
industry. 

ASSEMBLY LANGUAGE - A machine level language for programming. 

BAUD - A technical term to express the rate at which data may be transferred 
between computer devices. Generally speaking 300 baud means that data is being 
transferred at the rate of 300 bits per second* Even more generally it means 30 
characters per second although this is technically not quite correct. 

BASE - A quantity of characters for use in each of the digital positions of a 

numbering system. 

BILLBOARD - A message displayed at the beginning of a program showing the name 
of the program, its author and any other information the seller may feel is 
fitting or necessary. 

BINARY - A numbering system consisting of two symbols (0,1), representing a sum 
in which the individual quantity represented by each symbol is based on a 
multiple of 2 . 

BIT - A single "BINARY" digit whose value is "zero" or "one". 

BLANK LINE - A line whose first character is a carriage return. 
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fiif "A An bioT n L of t?\ as sm f x as ° ne character ° r as iarge •■ « «***• 

paragraphs. * ""^ & sentence ' or * paragraph or a group of 

SSeurihir ^^ the ^f ' S MchiJW langUage *"*»■ that i- oc every 

t^nea on S i„ P J, 8ran " l0ad6d aDd eXSCUted When the machilie is "••* 2 

turned on. It in turn automatically loads the necessary programs to cause the 

"KES into^ralion? 116 ^ '— ^ ^ "" " ChiM i! '*°™^™" « 

.BREAK - See ABORT above. 

BUFFER- An area of memory used for the temporary storage of data. 

2k to S haS a :e f maJL n ^Ln:: UltS ^ ** """"^ °< & ™' »> *» 

^55' (deciSl)." bitS "* A ^^ m3y represent an y numerical value between '0' and 
^M^eOETURN - A term that is the equivalent to "RETURN" or "ENTER" 

anymore, the term is still used and means to begin printing atthe home position 

fttn V^-? '' de P" din « ° D the Printer or software, also incite a ine 
feed. On the video screen a carriage return also means to start a new line. 

StpTaflcr'een^ R^bcS. nUmber ' "»«*»"» « •*■*<* appearing on the video 

S?i% SP ? " Ame "} od ° £ - verifying that data has been correctly read or written in 
which groups of digits are summed or added, and that sum is checked « a ins t a 
previously computed sum to verify that no digits have been changed since the 
last summation, a-m^c uie 

fSr-^" ? e * ction of casing or wiping out or deleting text from the face of 
the video display screen or from the FILE AREA. 

CLOBBERED - A slang term referring to the non-operation of software, hardware 

trrp^^'j.s.rs^ di ' (such as disk - tape)j »-»» « - — - 
s^-Et^T^ss's;^^: or noraal letter character that is — - 

COMMAND FTT.E - A file consisting of a list of commands to be executed in 
sequence - a machine language "object" file - usually commana i s t 

(p1nCIl%mdT DS1011 ' " /CKD "* ™ ELECTRIC PENCIL " 8UCh a 2LSS fiU 

SE^f^ V" Ia ° gUaSe ° r k6y S6qUenCeS ^ which « c °™°<* i- ^rmed 
enabling the computer operater to communicate with the machine and/or software. 
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CONTROL * A keyboard key that is used together with any letter key to create a 
control character. Unmodified TRS-80's (uppercase only) use the clear key to 
create control characters. When the TRS-80 is modified for lowercase entry and 
display, a separate control key may be added as part of the lowercase 
modification kit, 

CONTROL CHARACTER - A nonprinting ASCII character used to tell THE ELECTRIC 
PENCIL what to do. 

CRC ERROR - "Cyclic Redundancy Check" - a means of checking for errors by using 
redundant information. Used primarily to check disk input and output. 

CURSOR - A transparent white block which appears on the video display screen and 
is used to indicate the character or space about to be typed, moved, inserted or 
deleted. 

DCS - An acronym for "Device Control Block". A DCB is a section of memory in 
which the operating system stores information necessary to control other devices 
such as the printer, tape, and disk drives. 

DEFAULT ,, VALU E - A value assumed by a program whenever no value is specified by 
the operator. 

DELETE - The process of removing a character, a space, a line or a block of text 
from the video display screen. 

DIRECT ACCESS - Retrieval or storage of data by reference to its location on a 
disk, rather than relative to the previously retrieved or stored data. 

DIRECTORY - A table giving the relationships between items of data. Sometimes a 
table or an index giving the address of data. On the TRS^80 an index of programs 
and files stored on a diskette. 

DISTRIBUTION DISKETTE - The diskette on which programs are distributed. Also see 
MASTER DISKETTE below. 

DOS - Acronym for "Disk Operating System". A software program that manages the 
task of reading and writing disk files. It is usually transparent to the 
operator. 

DROP-OUT - The accidental failure to read or write a necessary character. 

DUMP - To transfer all or part of the contents of one section of computer 
memory, disk or tape into another section or to some other computer device. 

EJECT - A term referring to the action of a printer when feeding a page of 
paper. Also see FORM FEED belov. 

EOF - Acronym for "End Of File". 

FILE - A collection of related records, or characters treated as a unit* The 
word "file" is used in the general sense to mean any collection of informational 
items similar to one another in purpose, form and content. A file may be stored 
in memory, disk, tape or any other storage medium. 
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dit»5« i i entirety of text that has been entered onto the video 

display screen and subsequently into the memory of THE ELECTRIC PENCIL. All the 
text resident within the system at any given time is called a file. 

ELECT^^ H r?f are ?- in meni0ry that hae bee ° reserved f« the file. When THE 
llltJtt 11 • " *",? tUrned ° n ' this " ea " somatically determined by the 
5£Zy ^am^^g all available contiguous (adjoining) memory and claiming it. 
Whenever the file area is full, the message "FILE AREA FULL" will appear on the 

FILE NAME - The name of a particular file as stored. 

FILE PARAMETERS - The data that describes or defines the structure of the file. 

. FILE SPECIFICATION - FILE SPEC - The name and location of a particular file as 

» t OX 6Q| 

FLAKY - A slang term that alludes to less than acceptable performance. 
FORCE - To cause an action to take place before it is scheduled to happen. 

SS?J EE ? Zu A ch " acter entered into the file that will cause the printer to 
advance to the top of the next page. The character on the screen is the down 
arrow on the Model I or diamond character on the Model III. 

IfiEMAT - A specified arrangement of data or text for a desired clear presenta- 

Sn^d TE Y?ff KT ff I A diSkette WhiCh h3S bee ° P"P ared t0 -«"e data. It is 
considered "blank" but m reality it has been pre-recorded and certain necessary 
tiles put onto the diskette such as the directory and boot program. 

GAT - Acronym for "Granule Allocation Table"; A table from which available file 

ss^s'ns: 1 ;:^^!^^ 1 "- The gat tabie is iocated in the di — 

GRANULE - On the TRS-80 a "granule" is the basic unit of disk storage 
allocation. The number of sectors in a granule varies with the various operating 
systems and machines. The diskette directory file keeps track of free and 
assigned disk space in terms of "granules". See "GAT" above. 

H f SH , C0DE " A code nu mber generated and used as a direct addressing technique in 
wuicn a key word is converted to a number from which the required address is 
derived. See "HIT" below. 

. HEADER - A record or group of characters containing common, constant or 
identifying information for a group of records which follow. 

HIGH MEMORY - A term referring to the highest possible memory address that is 
accessible to the system. This address may be set to exclude memory which the 
program or operator wishes to use for special purposes. 

SSpptaS?^/" '^ h IndeX Table "« The HIT tab ^ is located in the diskette's 
DIRECTORY FILE. See "HASH CODE" above. 
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HEXADECIMAL - A numbering system consisting of sixteen symbols (0, 1, 2, 3, 4, 
5 * 6, 7, 8, 9, A, B, C, D, E, F) representing a sum in which the individual 
quantity represented by each symbol is based on a multiple of 16. The 
hexadecimal numbering system is especially convenient in computers because of 
the ease in translating binary information. 

INDEX - A table used to determine the location of a record or file* 

IPL - Acronym for "Initial Program Loader". A program usually executed upon 
pressing the reset button. 

JUSTIFICATION - The process of adjusting spaces within a line of text in order 
to create an even right-hand margin. 

KEY - (1) A button on the keyboard which when pressed, causes a character to be 
displayed on the video screen. (2) A special word, letter or phrase by which 
something is obtained. 

LABEL - A set of symbols or characters used to identify or describe an item, 
record, message or file. Occasionally it may be the same as the address in 
storage. 

LIST - An ordered set of data items. 

LOAD MODULE - A program developed for loading into storage and being executed 
when control is passed to the program. 

LOCK-OUT - Usually refers to tracks on a diskette that are not accessible 
because of damage or by user option. 

LOGICAL - An adjective describing the form of data organization, hardware or 
system that is perceived by an application program, programmer, or user; it may 
be different than the real or physical form* 

LINE FEED - A character in the file that will terminate a line and cause a new 
line to begin. The character on the screen is a left arrow and is typed into the 
file using the ENTER key. 

MAINTENANCE OF A FILE - (1) The addition, deletion, changing or updating of 
records in file. (2) Periodic reorganization of a file to better accommodate 

items that have been added. 

MACHINE CODE - A code consisting of binary numbers which upon machine 
recognition, causes a predefined sequence of operations to occur. 

MACHINE LANGUAGE - A language consisting of mnemonics and numbers which can be 
assembled into machine code which the computer can then execute. See MACHINE 
CODE above. Also see ASSEMBLY LANGUAGE above. 

MASTER DISKETTE - A diskette used only for the purpose of making copies of the 
programs contained on that diskette* 

MNEMONIC - (Pronounced: nee~mon-ick) A memory aid. Computer commands which have 
been shortened from their English words are referred to as a mnemonic. "DIR" is 
the mnemonic for "directory 1 '. 

MODF - A ttiPfhod nf ooeration- 
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NULL - An absence of information as contrasted with zero or blank for the 
presence of information. A null is the ASCII code #0 whereas the ASCII code for 
the character zero (0) is 48. 

NYBBLE - The four right most or left most binary digits of a byte, 

ON-LINE - An on-line system is one in which the input data enters the computer 

directly from their point of origin, and/or output data are transmitted directly 

to where they are used. The intermediate stages such as writing tape, loading 
diskettes or printing are avoided. 

OK- LIME STORAGE - Storage devices and especially the storage media which they 
contain, under the direct control of a computing system and available at any 
time for the storage and retrieval of data, 

OPERATI NG SYSTEM - Software which enables a computer to supervise its own 
operations, automatically calling in programs , routines , and data as needed for 
continuous operation. 

PARITY - Parity relates to the maintenance of a sameness of level or count, 
i*e,, keeping the same number of binary ones in a computer word and thus be able 
to perform a check based on an even or odd number for all words under 
examination. 

PAGE - Sixteen lines of text appearing on the video display screen. May be any 
number of lines of text when referring to a printed PAGE* PAGE may also refer to 
a number of bytes in memory; usually 256 bytes. 

PAGENATION - The process of automatically numbering pages, 

PRINT DRIVER - A software program which causes the line printer to function with 
the computer. 

PHYSICAL - An adjective, contrasted with logical* which refers to the form in 
which data or systems exist in reality. Data is often converted by software from 
the form in which it is physically stored to a form in which a user or 
programmer perceives it. 

POINTER - The address or a record (or any other data groupings) contained in 
another record so that a program may access the former record when it has 
retrieved the latter record. The address can be absolute, relative or symbolic, 
hence, the pointer is referred to as absolute, relative or symbolic. 

PRINTER - An electric or electronic typewriter like device that prints text from 
THE ELECTRIC PENCIL file area onto paper. 

PRINT VALUE - A value assigned to a printing function by the user or by the 
system. This value will determine Line Length, Page Length, Line Spacing, etc. 

RAM - Acronym for "Random Access Memory". See RAKDOM ACCESS below. 

RANDOM ACCESS - A storage techinque in which the time required to obtain 
information is independent of the location of the information most recently 
obtained. 

ROM - Acronym for "Read Only Memory" • This type of memory has data permanently 
stored in it and can only be read. It may not be altered in any way. 
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READ - The action of moving a file from a storage medium, such as tape or disk, 
and inserting it into the file area (loading a tape into the computer). 

RECORD - (1) As applies to THE ELECTRIC PENCIL program; any block of text that 
is terminated by an ENTER (ENTER key) or a FORM FEED. A record may be as short 
as one character or as long as the entire file. A record is most nearly like a 
paragraph. (2 ) A group of related data items treated as a unit by an application 
program* 

SEARCH - To examine a series of items for any that have a desired property or 
properties. 

SECTOR - A discrete area of storage on a diskette. 2 56 bytes on the TRS-80 

SCROLL - The action of the text moving up or down the video display screen. More 
than 16 lines of text (one page) must exist in the file for this action to 
occur. 

SOURCE CODE - The symbolic text from which machine code that may be executed, is 
generated. 

STRING - Any consecutive grouping of letters, spaces, numbers, punctuation or 
symbols. In this system, a string may be anywhere from i to 40 characters long. 

SYSTEM JFILE - A program used by the operating system to manage the executing 
program and/or the computer's resources. 

TABLE - A collection or list of data suitable for quick reference; each item 
being uniquely identified either by a label or it's relative position* 

TEXT - Any collection of characters, and words that can be read by* Text may or 
may not be machine readable but generally speaking, a "text file" is a literary 
effort. 

TOGGLE - A term meaning to switch on and off with the same instruction. If a 
device is ON then the next time the instruction which turned it on is issued, it 
will be turned off and vice-versa. 

TRANSPARENT - Complexities that are hidden from the user by the software. 

VERIFY - To check a data transfer or transcription 

VIDEO DISPLAY SCREEN - The electronic display unit of the TRS-80. Also called a 
CRT (Cathode Ray Tube), VDT (Video Display Terminal), monitor or simply, 
screen. 

WORD - Any number of characters with at least one space at either end. A WORD 
may be as short as one CHARACTER or as long as one line. 

WORKING DISK - A diskette containing the programs used for day to day 
operations. 

WRAP AROUND - On the computer this term refers to the presentation of characters 
on the video screen and means to continue a line of characters, when the right 
most edge of the display is reached, on the next line. 
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W&ITE - The action of moving text from the file area and recording it onto disk, 
cassette tape or otber storage medium ("recording" a tape from the computer), 

ZA2 - A slang term meaning to change something in memory or on a storage device 
such as a diskette* It may also refer to something which was accidentally 
changed. 
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APPENDIX II 

USING A SPECIAL PRINT DRIVER 



n There are three print drivers built into THE ELECTRIC PENCIL. They are: (1) A 
standard parallel print driver that outputs to the TRS-80 expansion interface 
parallel printer port. (2) The Small Systems Software TRS-232 serial print 
driver that outputs to the cassette port and (3) a serial print driver that 
outputs to the UART (RS232c) port. (Also see PLOAD and PSAVE above.) 

With this release of THE ELECTRIC PENCIL, custom print drivers may also be 
used without having to "patch" them into the system. The following procedure 
will allow you to use ANY print driver with THE ELECTRIC PENCIL. 

There are three ways to load a custom print driver. Method one permits you to 
load and initialize the print driver prior to loading and running THE ELECTRIC 
PENCIL. If yours is a tape or EXATRON STRINGY FLOPPY system you will have to use 
this method. 

Method two allows you to load your print driver from within THE ELECTRIC 
PENCIL program itself and method three allows you to load it automatically when 
you load and run THE ELECTRIC PENCIL. Methods two and three are for disk systems 
only . ' 

Method three requires that the print driver be a LOAD MODULE, which you may 
create with the "PSAVE" command from THE ELECTRIC PENCIL'S SYSTEM MENU. 

SPECIAL NOTE: There are two high memory address pointers. One for BASIC and one 
for the DOS. The ELECTRIC PENCIL uses both high memory addresses. Be sure to set 
at least one of the high memory addresses when initializing your print driver. 



LOADING THE PRINT DRIVER- Method one. (All systems) 

1. (a) NON DISK SYSTEMS - Set' MEMORY as you would for the print driver vou 
normally use. 

(b) DISK SYSTEMS - From "DOS READY" load BASIC and set MEMORY as you would 
for the print driver you normally use. 

2. With memory set, load your print driver and initialize the printer DCB 
with the print driver's entry address. 

3. (a) NON DISK SYSTEMS - Go to step 4, below. 

(b) DISK SYSTEMS - Return to "DOS" with the command: CMD"S" 

4. Load and run THE ELECTRIC PENCIL. The print driver you have loaded will 
now function, 

5. DISK SYSTEMS ONLY - If you have a print driver that will do all of the 
above automatically from DOS, then go to method 2 or 3 , below. 
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LOADING A PRINT DRIVER - Method two (Disk systems only) 

Once a "load module" has been created (see below) it may be loaded from THE 
ELECTRIC PENCIL'S SYSTEM MENU. Assuming you have already created the load 
module as described below, load and execute THE ELECTRIC PENCIL. Go to the 
SYSTEM MENU and type the following: 

PLOAD filespec<ENTER> 

The print driver will load, set high memory and initialize the printer DCB. You 
may PLOAD a print driver at any time. 



LOADING A PRINT DRIVER - Method thre P (Disk systems only) 

Assuming you have created the print driver load module (see below) you may 
load and initialize the print driver automatically each time you load and run 
THE ELECTRIC PENCIL just as if your print driver were part of THE ELECTRIC 
PENCIL. Using method two, above, get your print driver loaded and initialized 
then go to the SYSTEM MENU and type: 

SETUP <ENTER> 

THE ELECTRIC PENCIL will create a setup file called "PENCILOA/SYS". Your print 
driver will now be automatically loaded and initalized whenever you load and run 
THE ELECTRIC PENCIL (also see SETUP, above). 

SAVING YOU R PRINT DRIVER AS A "LOAD MODULE" (Disk systems only) 
NOTE: It is not possible to create a load module with tape or Stringy Floppy 
versions - all print drivers will have to loaded and initialized as in method 
one, above. 

Once the print driver has been loaded and initialized, it may be saved with 
an added program appendage that will, in the future, automatically set HIGH 
MEMORY and initialize the printev DCB. Once this "load module" has been 
created, it may be used at any time, by ANY PROGRAM. 

1. After you have taken the steps outlined in method one, above, load and run 
THE ELECTRIC PENCIL. Go to the SYSTEM MENU. 

2. From the SYSTEM MENU, type the following: 
PSAVE filespec<ENTER> 

NOTE: The "filespec" is the name you wish to give to your print driver and may 
include an extension and drive specification. 

3. Your print driver will be saved to disk with the file name you have given 
it and may now be loaded using Method two and three above. 

NOTE: THE ELECTRIC PENCIL will save the print driver from the current HIGH 
MEMORY address, to the end of memory. 
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APPENDIX 


III 


CUSTOMER 


SERVICE 



When you are having trouble, it is sometimes impossible to tell whether the 
trouble is hardware, software, or even if comes from an outside source such as 
the power company. With a device as complex as the computer it is amazing (a 
miracle?) that it works at all* Your 48K RAM machine has a total memory capacity 
of 64K (12K ROM + 48K RAM) and each of those 64 thousand bytes is made up of 
eight bits. That's over half a million bitsl This in itself is remarkable but 
what is more remarkable is that each one of those bits needs to be "recharged" 
every few micro- seconds ; the CPU has to manage its tasks at over 1 million 
instructions per second AKD IF ONE LOUSY BIT IS BAD, THE WHOLE THING CAN STOP 
WORKING i 

A comprehensive guide to hardware/software trouble shooting would be a large 
book in itself. Additional complications such as operating systems, diskettes, 
drives, interfaces and printers compound the complexity of the problem. THE 
ELECTRIC PENCIL was designed to run on standard Radio Shack computer systems. We 
have tried to take into account the various Radio Shack changes and alterations, 
the "usual 11 custom modifications that you might have made yourself and the 
various incompatibilities between the MODEL I and MODEL III machines. 

When you have trouble and before going into "panic mode", check the following 
items: 

1. Make sure that all cable connections are correct and that all edge card 
solder plated connectors are CLEAN!. 

2. That the system software is functioning correctly. If in doubt, power up 
from a "cold" start (everything off) and verify the systems operation with other 
programs that you know to be operating correctly. 

3. Verify that the system information, on the diskette, (usually the 
directory) is correct. If you have NEWDOS, or NEWD0S/80, use DIRCHECK to verify 
that system directory information is correct. If you are using another system 
praying may make you feel better but we have no verification that it has 
corrected any problems. 

4. Make sure that your peripheral devices (printers, disk drives , etc.) are 
properly attached, and in working order. 

5. When files mysteriously "disappear" from directories or when you are 
suddenly unable to load and save to particular diskettes look for the trouble to 
be related to the operating system (in most cases) and secondarily related to 
hardware problems with disk controllers or disk drives. Files do not just 
"disappear 11 . (See TRS-SQ DISK & Other Mysteries.) 
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ofobll C ?ho 0t /^ d "? rationa1 ' "asonable « electro-mechanical cause for your 
problem then follow the procedure below: 

sys C em R work! y ° Ur docunientation " »*** 8ure y° u understand how to make your 

with'rafELECTRlf^K^TT 1 ° ther P " 8rams that y° u m ^ be interfacing or using 
witn iufi &LECTRIC PENCIL are working correctly. 

the 3 l a ^ »T » hat /° Ur °P e " tin 8 s y s teni is up to date and that you are using 
tne latest zaps" and "patches" for that system. 

i-iw 4 ' I* 7 t( > du P licat e your error so that you can describe, IN WRITING, exactly 
tne nature of your problem. ? * 

circun,J!^ S c tbe / 0m ^ r K Vided in this a PP end i x » describe the Problem, the 
circumstances under which you encountered the problem, and what happens when the 
problem occurs. Fill out the form COMPLETELY. 

M*n 'fh/S 6 a C ^ P L° f ^T r SyStem disket te AMD your data diskette, if possible. 
Mail the form and the diskettes to: "*-=. 

IJG, Inc. 

1260 West Foothill Blvd. 

Upland, California 91786 

IJG "^i^ 8 S °° n aS P° ssible » attempt to determine if the cause of the problem 
is with THE ELECTRIC PENCIL program. In the event that it is, and not due to t" 
interfacing of other software or due to hardware problems, IJG will notify you 
by return mail, of any fixes, zaps or patches that may correct the problem. 

However, if your problem is unique to your use, application, situation or 
hardware configuration, IJG will not attempt to define your particular problem. 
IMany times the software is used in ways which the designers and writers did not 
contemplate.) You will be notified, by return mail, of any conclusions that IJG 
may make regarding your problem. 

All problem inquiries will be handled by mail only. 



NOTICE 



DISKETTES WILL NOT BE RETURNED UNLESS ACCOMPANIED BY AN ADDITIONAL SHIPPING & 

HANDLING FEE OF $2.50. 



In the event that you have damaged your original program diskettes, return the 
damaged original program materials along with the fees listed below: 



Diskette: $12 .50 

Cassette: 10.00 

ESF wafer: 10.00 

Shipping & handling: 2.50 



Additional copies of the documentation will be supplied at $24.95 (Calif, 
residents add 6% SALES tax) +2.50 shipping and handling. 

^boJe! 11 materials ' re <* uests and Service Difficulty Reports to the address noted 
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SERVICE DIFFICULTY REPORT - SDR Number 1PR/ 



SOFTWARE PACKAGE; DATE: 

NAME: 

ADDRESS : 



CITY; ^___ STATE ; ZIP : PHONE : 



Source or Micronet ID: DISKETTES ENCLOSED: (Y) (H) 

TRS^SO MODEL I ( ) MODEL III ( ) TAPE ( ) STRINGY FLOPPY ( ) DISK ( ) 

MEMORY; ( )48K C )32K C )16K UPPER/ LOWER CASE (Type): 

Expansion interface if other than Radio Shack: 

Operating System: Version: 

Zaps or patches thru (Date or ZAP no.}: 



Disk drive units (Mfg); Model: No. 

Printer (Mfg.): Model: Type: 

Additional Hardware Modifications (List mfg. & model): 



I have had my computer system approximately years, months. I have 

had my disk system years, months. 

Description of problem: 



Circumstances under which it occured: 



IJG OFFICE USE 



Recommendation : 



By: Date: 



Action: 



By: 4 Date: 



E? ( ) Sys Svr ( ) Dsk Drv ( ) Pnt ( ) Pnt I/F ( ) Pnt Dvr ( ) 
J/V ( } DcV ( 1 CPU r 1 Mpm { ) UNK ( ) LOG : SF: 
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APPENDIX IV 



FUTURE ELECTRIC PENCIL PRODUCTS 



There are many applications and utility applications for a word processor, 

such as THE ELECTRIC PENCIL, The following are planned future program releases 

and publications that will use or enhance THE ELECTRIC PENCIL word processing 
system. 

THE ELECTRIC PENCIL HANDBOOK - An extensive guide to THE ELECTRIC PENCIL 
documenting the internal program operation, the exact locations of the various 
routines, constants, variables and tables . The program's source code (for disk 
only), with symbolic labels, and comments are included in this book - a must for 
machine language progammers, developers and hobbyists who wish to modify THE 
ELECTRIC PENCIL for special applications. $29,95 

BLUE PENCIL - A text proofing addition to THE ELECTRIC PENCIL, BLUE PENCIL reads 
the text file and notes any spelling errors on the video or printer. It 
recognizes prefixes, suffixes, hyphenation and comments. The word dictionary is 
infinitely expandable - by you! You can add or delete your own vocabulary of 
words to BLUE PENCIL'S dictionary - 

BLUE PENCIL Comes with a 50,000 word dictionary (equivalent to a Webster's 
Pocket Dictionary*) Typical proofing time for a 6000 word text file is under two 
minutes. Requires 32 K minimum, 1 disk drive. 

RED PENCIL - A text correction addition to THE ELECTRIC PENCIL. RED PENCIL 
automatically CORRECTS errors detected by BLUE PENCIL. RED PENCIL displays each 
misspelling and typo separately and offers you a choice of options which 
include: retyping the misspelled word, leaving it as is, adding it to the 
dictionary or displaying the word in context. If you choose to display the word 
in context, then you are again offered the first three choices. The text is 
instantly corrected and you may then proceed with your word processing chores. 
Typical correcting time for a 6000 word file is under two minutes. (Note: time 
may vary depending on the number of spelling errors,) Requires 32K Minimum, 1 
disk drive and BLUE PENCIL. 



PENCIL- GRAM - A fully developed communications interface permitting the sending 
and receiving of data files, text files > and binary files via the RS232c 
interface. Text program and data files may be sent or received from the keyboard 
or buffer. Requires 32K, 1 disk drive, RS232c interface and modem. 

TALKING PENCIL - A word processor for visually handicapped persons that 
incorporates all of the features of THE ELECTRIC PENCIL 2.0. Talking pencil will 
"pronounce" each letter as it is typed, each word, as it is completed and will 
"read" the text as well as print it. Commands and menu selections are announced 
as are all parameter settings. Requires 48K 2 disk drives, RS232c interface and 
voice synthesizer. 
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typesetting and composition LchinL if. *^ A"toLo s ic 600 automatic 
embedding of typesetting codes Zh ^! ,' f f o£tvare ""rface permits the 
files ate tralsmUted t° the lLT,J, J """ ° £ th ° se codes vh °* ">. text 
disk drives. typesetter. Requires THE ELECTRIC PEKCIL, 48K, 2 

ttP^erSL-ie^rot SSdLT^^T,^^? "^I ™™ 

j pnnc personalized letters from within THE ELECTRIC PENCIL. 

DRAWING PENCIL - A graphics addition to THE ELECTRir Pfwptt ■ *u 

generate and print TRS-Rfl c «n>,,« i, ^M*™^ PENCIL with which you can 

characters. P 8 ° §ra P hlcs characters in addition to the regular text 

mcii sill ~ 4m1« input /output tl that a wm dditi ° nal f "" Ur " t0 ™ ELECT *" 
characters and the output characters A file J*™.? y ° U t0 . define the keyboard 

-JUg^ Permits STlilJ^ ^n^IiXR^s^"^-.-^^ 

?U IV !k- V i4 6t ° f PriDt drivers for serial and parallel printers Fnl„ 

themselves" „„ ." wnere theHave beeML/a * Ut " UtUity t0 " fi « i 
features s„c h as BREAK ^^Tl^lc ^ Leaned T^Ho ""I 

2 «£ BSTLiic! 01 EVEB AIIACHED - Ih °" ««» -» *■»■* S^r ££ 

Prxnt drivers included are: 

NEC Parallel Bi-directional 

NEC Serial Bi-directional 

Diablo parallel bi-directional 

Diablo Serial bi-directional 

"Standard" Serial 

Teletype- 33 20ma current loop driver 

IMPROVED ROM driver (parallel) 

TRS232 driver 

BASIC "configuration" program 



Requires TRS-80 



s„u\ce code. «*««/*— »« tape or APPARAT diss assembler to assembi. 



THE 



California 91786 ' I ° C - > : "° W " *>««U Blvd., Upland* 
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APPENDIX V 



OTHER PROGRAMS THAT WORK 
WITH THE ELECTRIC PENCIL 



Many programs are offered by other vendors that enhance or work with THE 
ELECTRIC PENCIL. These programs fill the special needs of many users* Some of 
these programs modify THE ELECTRIC PENCIL itself and others use the files 
created by THE ELECTRIC PENCIL, Beginning with this release of THE ELECTRIC 
PENCIL j independent programmers may obtain an endorsement, for their product, 
that will assure you that their addition works with THE ELECTRIC PENCIL. 

An "APPROVED ELECTRIC PENCIL COMPATIBLE PROGRAM" will carry this seal of 
approval: 




This seal is your guarantee that this is a truly compatible product* That it has 
been tested and it performs as advertised with THE ELECTRIC PENCIL. 

If you have a program or enhancement that works with THE ELECTRIC PENCIL, and 
wish to have your product carry this seal, contact: 



IJG, Inc. 

Marketing Dept, 

1260 West Foothill Blvd. 

Upland, California 917 86 

As an additional help in developing THE ELECTRIC PENCIL compatible programs, you 
may obtain commented source code for THE ELECTRIC PENCIL Version 2.0 in "THE 
ELECTRIC PENCIL HANDBOOK". This book is scheduled for release in mid 1982 and 
will be available from IJG or your IJG dealer for $2 9.95. It is a reference 
guide to assist you in modifying, adding, and enhancing THE ELECTRIC PENCIL 
programs. (See APPENDIX IV above.) 
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MICROSOFT. BASIC 

DECODED 

AND OTHER MYSTERIES 

by James Farvour 

Microsoft Basic and Other Mysteries is the definitiveguide to your Levelll 
ROMs. With more than 7,000 lines of detailed comments and 6 additional 
chapters packed with information, it is easily the biggest and best book 
about the Level II ROMs available. 

Exploit the full power of Microsoft Basic with the aid of more than 300 
pages of tested examples, explanations, and detailed comments. Microsoft 
Basic and Other Mysteries is yours for only $29.95 (plus $3.00 shipping. 
CA residents add $1,80 sales tax, Canadaa add 20% for exchange rate.) 

* IM, Microsoft 



THE ClZiTQMTR&XO 

*t- OTHER ATCSTEKIES -.; :Z % 




THE CUSTOM TRS-80, 
AND OTHER MYSTERIES 

by Dennis Bathory Kitsz 

Ever wanted to do things to your TRS-80 that Radio Shack said couldn't 
be done? How about reverse video, high resolution graphics, and audible 
keystrokes? 

Not enough? How about turning an8-track into a mass storage device, 
making music, controlling a synthesiser, individual reverse characters, 
and a real-time clock just to name a few? 

The Custom TRS-80 and Other Mysteries is packed with more than 290 
pages of practical information and can be yours for only$29.95 (plus $3 .00 
shipping. CA residents addSl ,80 sales tax, Canada add20% for exchange 

rate.) TRS-SO is a trademark of Tandy 



Matrix ttf*Mfrtfpitt*'f 
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BASIC FASTER AND BETTER 
AND OTHER MYSTERIES 

by Lewis Rosenfelder 

Basic is not nearly as slow as most programmers think. Basic Faster and 
Better shows you how to supercharge your BASIC with almost 300 pages 
of fast, functions and subroutines. 

You won'l find any trivial poorly designed ll check-book balancing 11 
programs in this book— if s packed with useful programs. 

Tutorial for the beginner instructive for the advanced, and invaluable for 
the professional, this book doesn : s just talk , . . it shows how! All routines 
are also available on disK so that you can save hours of keyboarding and 
debugging. 

The #1 disk BFBDEM contains all the demonstration programs, and 
#2 disk 8FBUB has all the library functions, 

Basse Faster and Better is $29.95, and the two disks are S 19.95 each 
(plus S3 ,00 shipping for book and disks together or separate. CA residents 
addS1 .80 sales tax for the book, disks add $1 ,20 each. Canada add 20% 
for exchange rate.) 
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Don't boot-up 
without it! 



Thv*Mt»9rTn m htmk of 
Tit&~&1hfiafa Jwor*>#7/ 

• 130 page, 8V2 x 11 soft cover 

• Actual memory maps, samples 

• Detailed recovery instructions 

• Recover lost programs, DOS errors 

• Fix parity, gat and hit errors 

• Recover from unreadable directory 

• Fix Electric Pencil file errors 

• Recover lost or killed files 



JUST $22.50 



Get it and a a ret I tin* many r/fafl* >nt/sf<>ti<>s 
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5.1 RECOVERING HASH 1 CODES 

3.2 RECOVERING A KlL 1. ELJ FILE 

9 3 RECOVER 'DESK WONT READ OR BOOT* CLO&6ERE0 OR 
UNREADABLE DIRECTORIES. SECTOR ZERO * PHYSICAL 
OR ELECTRICALLY DAMAGED DISKS 

G4 RECOVERJNG A RAD PARRITV ERROR 

9 5 RECOVERING A DIRECT STATEMENT IN FILE' ERROR. 
ASCII "BASIC & BiNARY BASIC FILES 

9 6 RECOVER "HIT SE^tUH FRRORS 

3 7 PECOVEPI GAT SECTOR ERRORS 

3.a RECOVERING ELECTRIC PENCIL' ERRORS.* DOS ERROR 
32 • LOST PENCIL FILES IN MEMORY* LOST PENCIL 
FILES ON THE DISK* OVERWRITTEN PENCJL FiLES* 

9 9 RECOVERING DATA FJLES • ASCII AND RANDOM TfLES. 

10.0 CORRECTING THE GAT AND HIT SECTORS 

10 1 'HE HIT FIX 
10.2 THE GAT FIX 

HO FrLES- STRUCTURE 

: 1.1 BINARY BASIC PROGRAM F^LES 

1 1.3 ASCII BASIC- PROGRAM FILES 

11 J ASC:i DATA FILES 

1 I.J RANDOM DATA FILES 
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I 1 6 SYSTEM FiLES 
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12.0 SOMETHINGS YOU CAN DO 

12 I CONSTRUCTING ELECTRIC PENCIL FILES IK -BASIC" 

12 3 MAKING DATAHLES INTO ELECTRIC PENCIL FILES 

12 3 CONVERTING "DATA TYPtS' IN RANDOM FILES 
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QRDLR^NG NEW^OS^VD HIJPERZAP 

-SEARCH-' PROGRAM LISTING & DOCUMENTATION 



DISK MAP (TRSDOS 3.3i * DIRFCTORY MAP. GAT SECTOR MAP 

GRANULE ALLOCaTjON MAP* HIT SECTOR MAP 

FPDE/FXDE SEC10R MAP* DIRECTORY ENTRY MAP 



S3*A Vi3» VAl *«* 9 « W 



9 



ACTUAL TYPE SIZE 



S* UV9 \£\ 353« 



3^ c 



\«s l, A\ sVw *2gS *^ 

5S* 1 4 «.V*5 3 ^ 2 ,, e 6B« 






0? 



&*»«* 




ot^ e 



ise 



6 t>^ a ^ e * 



ksi c 



^*^P. 



iti 



co^ 



THE ELECTRIC PENCIL Version 2. Oz 



122 



COMMAND 



QUICK REFERENCE GUIDE 



FUNCTION 



PAGE 



CURSOR CONTROL 

<-<-> 


. CURSOR LEFT 


...« 18 


<*-> 


. CURSOR RIGHT 


* •.* 19 


<!> 


. CURSOR UP 


. .. * 20 


< t> 


. CURSOR DOWN 


.... 21 


<CTL>-<Q> 

<CTL>-<N> 


. CURSOR HOME 


. ... 22 


. CURSOR to FILE END 


.... 23 


<CTL>-<B> 


, CURSOR to FILE BEGINNING *.. 
• SCROLL UP (forward) 


. * . . 24 


<CTL>-<E> 


.. .. 25 


<CTL>-<X> 


* SCROLL DOWN (backward) 


.... 25 


<SHIFT>-<CLEAR> 

<SHIFT>-<-^> 


. CURSOR TO BEGINNING OF LINE 
. TAB RIGHT 8 SPACES 


- # . • 26 

9 7 




EDITING 

<CTL>-<D> 


. DELETE CHARACTER 


..♦, 28 


<CTL>-<F> or <CTL>-<I> 


, INSERT CHARACTER , 


.. .„ 29 


<CTL>-<Y> 


♦ DELETE LINE 


.... 30 


<CTL^<G> 


* INSERT LIKE 


. . .. 31 


<CTL>-<T> 


» ERASE to END of LINE 


. .., 32 


<CTL2-<U> 


, DELETE BLOCK 


. ... 33 


<CTL>-<H> 


. INSERT BLOCK 


. .., 33 


<SHIFT>-<|> 


. BLOCK MARKER CHARACTER 


. . . . 34 


<SHIFT>-<^> 


. BACKSPACE ix ERASE 


IS 




UTILITY 

<CTL>-<V> ,; 


. STRING SEARCH 


... , 39 


<CTL^<C> 


. CONTINUE SEARCH 


. , . . 40 


<CTL>-<R> 


. REPEAT FUNCTION 


. .., 42 


<CTL>-<K> 


. SYSTEM MENU 


. ... 43 


<CTL^<P> 


. PRINT MFNTT 


A1 





SPECIAL PURPOSE 

<BREAK> ABORT & EXIT CURRENT MODE 44 

<CLEAR> "CONTROL" KEY 44 

<SHIFT^<0> UPPER/LOWER CASE LOCK 44 

<SHIFT>-<BR£AK> UPPER/LOWER CASE LOCK 44 

<SHIFT>-<ENTER> DICT-A-KATIC ON/OFF 44 

SPECIAL CHARACTERS 

<SHIFT>»<t> FORMFEED 36 

<ENTER> TERMINATE RECORD (line feed) ..,36 

<CLEAR>-<0> UNDERLINE CHARACTER 36 

<CTL>-<£PACE> HARD SPACE CHARACTER 37 

<CTL>-<+-> CONCATENATE CHARACTER 38 

Special SEARCH & REPLACE characters (see pages 39-41): 



<SHIFT>-<^> <ENTER> CHARACTER 

<SHIFT>-< + > FORI! FEED CHARACTER 

<CTL^<--> "WILD CARD ,T CHARACTER 

<CTT^<-*> "WTTTX* 1 n*URAr,TKR 
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SYSTEM MENU 
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ABBREVIATION COMMAND PAGE 



UTILITY FUNCTIONS; 
Number of words in file « 
Number of records in file 
Amount of free memory , , 



USED WORDS ...48 
USED RECORD ... 48 
FREE MEMORY 36600 ... 48 



SPECIAL UTILITY COMMANDS (NOT DISPLAYED IN MENU): 

Save program configuration . . SETUP 49 

Save print values PVOFF !!!!!!!"!!! 49 

Do not save print values . . . PVON 



SYSTEM COMMANDS: 

Set cursor speed CURS 

Set tape speed (baud) • . . * . TAPE 

Save print driver SAVE 

Load print driver LOAD 

Clear all text after cursor . . CLER 

Clear all text before cursor . . CLER 

Clear all text from memory « . . CLER 

Return to DOS READY EXIT 



FILE COMMANDS; 
Save file to tape cassette . 
Load file from tape cassette 
Verify file on tape cassette 
Save file to Stringy Floppy 
Load file from Stringy Floppy 
Erase file from Stringy Floppy 
Display diskette's directory 
Save file on diskette . . . 
Load file from diskette . . 
Kill file on diskette . . . 



SAVE 
LOAD 
VRFY 
SAVE 
LOAD 
ERSE 
DISK 
SAVE 
LOAD 
KILL 



SPEEDS 
SPEEDS 
PRTDVR 
PRTDVR 
AFTCUR 
BEFCUR 
ALLTXT 
TO DOS 



CASSETTE 

CASSETTE 

CASSETTE 

SFLPPY 

SFLPPY 

SFLPPY 

DIRECTRY 

DSK FILE 

DSK FILE 

DSK FILE 



CI- 10 
LO-HI 
PSAVE 
PLOAD 
CAA .. 
CAB *, 
CLE .■ 
EXIT , 



CSAVE 

CLOAD 

CLOAD? 

0SAVE 

@LOAD 

@NEW , 

DIR 

SAVE 

LOAD 

KILL 
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. 50 

* 50 

* 51 

* 52 

* 53 
. 53 

* 53 

* 53 




PRINT MENU 



COMMAND 



PAGE 



PRINT VALUES 

Justify right margin jtj 

Set left margin L jj 

Set line length LL 

Set line spacing Lg 

Set number of lines per page PL 

Set number of lines between pages ps 

starting page number. * PN 



Set 



Set number of records to print 



PR 



PRINTER CONTROL COMMANDS 

Set printer to halt on form feed HF 

Line feed with carriage return off/on . [ \ CR 

Carriage return with line feed off/on . . . LF 

Set RS232c & TRS232 baud rate B S 

NN 
UP 



Set number of nulls on serial output 

Set parity on serial output , . , 

Set number of stop bits (serial output) \ \ SB. ! ] " ] * 77 

Set serial word length . . UW 78 
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75 
76 
76 
76 
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77 
77 
77 
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PRINTER PORT CONTROL 
Select parallel printer port . . 
Select TRS232 serial/cassette port' 
Select RS2 32c (UART) serial port . 



• . PA 
. • TR 

. , UA 
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